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

C H A P T E R 1 5
Filing
About Filing 15-7
The protoClockFolderTab is a variation on protoNewFolderTab
that displays the current time as its title text. Do not attempt to replace this
text; if you want to display your own title text in a folder tab view, use a
protoNewFolderTab view rather than a protoClockFolderTab view.
Figure 15-7 depicts a typical protoClockFolderTab view.
Figure 15-7 A protoClockFolderTab view
Either kind of folder tab view sends a TitleClickScript message to your
application when the user taps its title text. The protoClockFolderTab view’s
default TitleClickScript method opens the built-in Clock application. The
protoNewFolderTab view provides no default TitleClickScript method.
Your folder tab view can provide its own TitleClickScript method to
customize the action it takes in response to a tap on its title text. Your
titleClickScript method accepts no arguments.
Both kinds of folder tab views rely on an appObjectUnfiled slot that you
provide in your application’s base view. This slot contains the full text of the string
“Unfiled
items ”, in which items is the plural form of the target your application
manipulates; for example, “Unfiled Notes.” This string appears in the folder tab
view when the application displays data items not associated with any filing
category. This string is also displayed in the picker that opens when the user taps
the filing tab.
Both kinds of folder tab views also rely on the use of an appAll slot that you
provide in your application’s base view. This slot contains the full text of the string
“All
items ” in which items is the plural form of the target your application mani-
pulates; for example, “All Notes.” This string appears in the folder tab view when
the application displays all its data items (including those that are not filed). This
string is also displayed in the picker that opens when the user taps the folder tab.
Tapping the folder tab displays a picker from which the user can choose a filing
category. Your application must filter the display of filed items according to the
category selected in this list; hence, the value retrieved from this list is referred to
as the filing filter. A check mark appears next to the currently selected filing filter;
the user can tap an item in the list to select a new filing filter. In addition to
selecting a filing filter in this picker, the user can specify whether to display items