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

Chapter 11 - Miscellaneous / Reference

Functions and Methods / Built-In Applications

KillStdButtonBar

KillStdButtonBar(buttonBarParams)

Closes (or restores) the standard button bar, and reserves screen area for a new one.

buttonBarParams

A 4-element array or nil. Pass the value nil to restore the standard button bar. If you pass an array, each element should be a frame specifying where to save screen space for the replacement button bar in the four different screen orientations. The array elements should be ordered as specified by "Screen Orientation Constants"; that is, buttonBarParams[kPortait] should hold information for the portrait screen orientation.

These frames should have the following slots:

buttonBarPosition One of the following symbols: 'top, 'bottom, 'right, 'left, or 'none. These symbols specify where to reserve space for the replacement button bar. Specify 'none if you do not wish to reserve this space.

buttonBarThickness An integer specifying how much space to save for the button bar in pixels. You may not omit this slot, unless buttonBarPosition is set to 'none.

return value

Undefined; do not rely on it.

DISCUSSION

If the app area becomes less than 320 pixels high as a result of a call to *KillStdButtonBar, views without a ReorientToScreen method cannot open.