beautypg.com

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

Page 570

background image

C H A P T E R 1 5

Filing

15-4

About Filing

Filing and other system services display user messages containing a string that is
the user-visible name of your application. For example, this string is used to complete
the text displayed when the user creates a local folder. You need to create in your
application’s base view an

appName

slot that holds this string. Figure 15-3 depicts

the text displayed when the user creates a folder that is local to the Notepad
application.

Figure 15-3

Creating a local folder

The system determines whether to display global or local folders by testing the
values of optional slots you can supply in the application’s base view. You can set
the value of the

localFoldersOnly

slot to

true

to cause the Filing slip and

folder tab views to display only the current application’s local folders. You can set
the value of the

globalFoldersOnly

slot to

true

to cause the Filing slip and

folder tab views to display only global folders. When these slots are both

nil

or

missing, the Filing slip and folder tab display global folders and the current
application’s local folders.

W A R N I N G

The

localFoldersOnly

and

globalFoldersOnly

must not

both hold non-

nil

values at the same time.

Your target view can provide an optional

doCardRouting

slot to control the

display of the buttons that specify the store on which to file the target. When an
external store is available and the value of the

doCardRouting

slot is

true

, the

Filing slip includes buttons that represent available stores.

You must supply the full text of the string that labels this group of store buttons.
This string is held in an

appObjectFileThisOn

slot that you provide. Similarly,

you must supply the full text of the string labelling the group of buttons that
represent filing categories. This string is held in an

appObjectFileThisIn

slot

that you provide. Figure 15-2 shows where the Filing slip displays these strings.

"Notepad"

string is from

appName

slot