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

C H A P T E R 1 5
Filing
Using the Filing Service 15-11
■ Create a storesFilter slot in your application’s target view
■ Implement the FileThis and NewFilingFilter methods.
■ 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
■ create a doCardRouting slot in your application’s base view
■ create a dontStartWithFolder slot in your target view
■ implement support for local or global folders only
■ customize the title text in your protoNewFolderTab view
■ provide a TitleClickScript 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 15
Each of your application’s soup entries must contain a labels 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 labels slot.
Setting the value of the labels slot is really the only “filing” that is done—the
entry still resides in the soup, but your FileThis and NewFilingFilter
methods provide the user-interface illusion that the data has been put in a folder.
The labels slot can store either a symbol or the value nil . If the value stored in
this slot is nil , your FileThis method must treat the item as unfiled. If a symbol
is stored in this slot, your FileThis method must test the value of this slot to
determine whether the entry should be displayed and then redraw the display
appropriately. Similarly, your
NewFilingFilter method tests the value of this
slot to determine whether to display the item when the filing filter changes.
Creating the appName Slot 15
You must create in your application’s base view an appName slot containing a
string that is the user-visible name of your application.