C H A P T E R 1 5
Using the Filing Service
slot in your application's target view
Add a filing button view and a folder tab view to your application.
Register a callback function with the folder change notification mechanism.
Optionally, you can
slot in your application's base view
slot in your target view
implement support for local or global folders only
customize the title text in your
method to customize the action your folder tab
view takes when the user taps its title text
The sections immediately following describe these tasks in detail.
Creating the Labels Slot
Each of your application's soup entries must contain a
slot. It is
recommended that you make this slot part of a default soup entry created by a
frame-constructor function you supply. (For information on the use of frame-
constructor functions, see "Programmer's Overview" on page 11-25 in Chapter 11,
"Data Storage and Retrieval.")
When the user files a soup entry, the system stores a value in its
Setting the value of the
slot is really the only "filing" that is done--the
entry still resides in the soup, but your
methods provide the user-interface illusion that the data has been put in a folder.
slot can store either a symbol or the value
. If the value stored in
this slot is
method must treat the item as unfiled. If a symbol
is stored in this slot, your
method must test the value of this slot to
determine whether the entry should be displayed and then redraw the display
appropriately. Similarly, your
method tests the value of this
slot to determine whether to display the item when the filing filter changes.
Creating the appName Slot
You must create in your application's base view an
slot containing a
string that is the user-visible name of your application.