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

Chapter 11 - Miscellaneous / Reference

Functions and Methods / Utility Functions

GetAppParams

GetAppParams()

Returns a frame containing information about the screen size and other system configuration items.

return value

A frame with the following slots:

appAreaTop The y coordinate of the top-left corner of the application area. Children of the root view are always opened relative to the application area. This value is always 0.

appAreaLeft The x coordinate of the top-left corner of the application area. This value is always 0.

appAreaWidth The width of the screen in pixels.

appAreaHeight The height of the screen in pixels.

buttonBarPosition A symbol, either 'top, 'left, 'bottom, 'right, or 'none indicating where the button bar is, if there is one. This is useful if you want to locate your application flush against the button bar.

appAreaGlobalTop The y coordinate of the top of the application area in global coordinates.

appAreaGlobalLeft The x coordinate of the left of the application area in global coordinates.

buttonBarBounds If there is a soft button bar this slot contains its view bounds.

COMPATIBILITY

Versions of this function previous to Newton 2.1 OS return a frame without the appAreaGlobalTop, appAreaGlobalLeft, and buttonBarBounds slots.