Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 11 - Miscellaneous / Reference

Functions and Methods / Stationery

RegStationeryChange

RegStationeryChange(regSymbol, functionBody)

Registers a function object to be executed when stationery is installed or removed.

regSymbol

A unique symbol that includes your developer signature.

functionBody

Function object called when stationery changes. This function body takes four arguments:

message A symbol, currently the symbols 'install and 'remove are used.

defType A symbol, currently the symbols 'dataDef and 'viewDef are sent, for the type of stationery that has been installed or removed.

symbol1 The dataDef symbol of the installed or removed stationery.

symbol2 If defType is 'dataDef, then this is undefined. If defType is 'viewDef, then this is the viewDef symbol of the installed or removed stationery.

return value

Undefined; do not rely on it.

SPECIAL CONSIDERATIONS

The function passed in the functionBody argument must not itself call *RegStationeryChange or UnregStationeryChange.