Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) - Manual (Page 710)

C H A P T E R 1 9
Built-in Applications and System Data
19-36 Auxiliary Buttons
Prefs and Formulas Compatibility 19
The functions RegPrefs , UnRegPrefs , RegFormulas , and UnRegFormulas
are new to the 2.0 system.
Using the Prefs and Formulas Interfaces 19
This section describes how to add panels to the Prefs and Formulas rolls.
Adding a Prefs Roll Item 19
The RegPrefs function adds a panel to the Prefs rolls. This roll is not intended for
application-specific preferences, but rather for system-wide preferences.
Application-specific preferences should be set through an information button (an
“i” button) in the application base view’s status bar. For more on the information
button, see
newtInfoButton or protoInfoButton , depending on whether
you are working in the NewtApp framework or not.
The item added to the Prefs roll should be based on protoPrefsRollItem . The
UnRegPrefs function reverses the effects of the RegPrefs function.
Adding a Formulas Roll Item 19
The RegFormulas function adds a panel to the Formulas roll. There is no proto
tailored for use as a Formulas panel. Instead, you should attempt to make your
panel look and act like the system-supplied panels. For an example of a template
with the look of the built-in Formulas panels, see the DTS sample code related to
the Prefs and Formulas rolls.
The UnRegFormulas function reverses the effects of the RegFormulas function.
Auxiliary Buttons 19
This section describes the use of auxiliary buttons. Figure 19-9 shows the effect of
adding an auxiliary button to the Notes application.
About Auxiliary Buttons 19
A set of functions allow you to add buttons to the status bars of the Notes and
Names applications. Third-party applications can use this mechanism to allow
themselves to be extended.
Auxiliary Buttons Compatibility 19
The auxiliary buttons mechanism is new to the Newton 2.0 system.