C H A P T E R 1 5
Using the Filing Service
declare your folder tab view to the application's base view. The system sets the
folder tab view's bounds for you at run time, positioning the folder tab relative to
its parent, near the top of the screen.
Customizing Folder Tab Views
proto supplies a child view named
a string that you may supply optionally. To display your own string as the title text
view, use the global function
to set the
value of the
slot in the
view child of your folder tab view.
SetValue(myNewFolderTab.title, 'text, "My text");
W A R N I N G
Do not create a
slot in any folder tab view. Do not replace
the title text in a
Defining a TitleClickScript Method
The folder tab view's
method is invoked when the user taps
the title text in a
view or the time displayed as title text in
view. The default
views does nothing. The default
method provided by the
displays the built-in Clock application.
You can provide your own
method to customize the action
your folder tab views take when the user taps them.
Implementing the FileThis Method
When the user taps the File button in the Filing slip, the system sends the
message to the target view. Your
method must perform any
actions necessary to file the target and redraw the current display appropriately.
For example, if your application is displaying an overview list of unfiled items
when it receives this message, your
method needs to redraw the list
without the newly filed item in it, providing the user-interface illusion that the item
has been moved.
method must also handle the case in which the user re-files an
item in the category under which it already resides. In this case, the appropriate
response is to do nothing; unnecessarily redrawing views that have not changed
makes the screen appear to flicker or flash. Because the value of the target's
slot does not change unless you change it, you can test this slot's current
value to determine whether the new value is different.