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
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.
"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.
"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
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