beautypg.com

Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) User Manual

Page 580

background image

C H A P T E R 1 5

Filing

15-14

Using the Filing Service

Creating the labelsFilter slot

15

Your application’s target view must supply a

labelsFilter

slot. This slot holds

a value indicating the current filing filter selected by the user in the picker displayed
by the folder tab view. This slot can store either a symbol indicating the currently
displayed filing category or the value

nil

(which specifies that the Unfiled category

is currently displayed).

The system sets the value of the

labelsFilter

slot for you. Your

NewFilingFilter

method must update the display of your application’s

data according to the value of this slot.

To display a predetermined filing category when your application opens, you can
set an initial value for the

labelsFilter

slot from within the application base

view’s

ViewSetupFormScript

method.

Creating the storesFilter slot

15

Your application’s target view must supply a

storesFilter

slot. This slot stores

a value indicating the current store filter selected by the user from the picker
displayed by the folder tab view. This slot can store either a symbol or the value

nil

.

The system sets the value of the

storesFilter

slot for you. Your

NewFilingFilter

method must update the display of your application’s

data according to the value of this slot.

To display items on a particular store when your application opens, you can set an
initial value for the

storesFilter

slot from within the application base view’s

ViewSetupFormScript

method.

Adding the Filing Button

15

You need to take the following steps to add the

protoFilingButton

view to

your application:

In NTK, sketch the filing button using the

protoFilingButton

proto and

declare it to the application’s base view.

Set appropriate values for the button’s

viewBounds

slot.

Adding the Folder Tab View

15

Your application’s base view must provide a view that displays the currently
selected filing category and allows the user to select a new filing category. This
view is based on either the

protoNewFolderTab

or

protoClockFolderTab

system proto.

Adding the folder tab view to your application is easy. In NTK, sketch the folder
tab in your application’s base view using the

protoNewFolderTab

proto and