beautypg.com

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

Page 585

background image

C H A P T E R 1 5

Filing

Using the Filing Service

15-19

Using Local or Global Folders Only

15

To suppress the display of either local or global folders in the Filing slip and the
folder tab views, you can set the values of optional

localFoldersOnly

and

globalFoldersOnly

slots that you supply in your application’s base view. Note

that the use of local or global folders only is intended to be an application design
decision that is made once, rather than a user preference that can change.

When the

localFoldersOnly

slot holds the value

true

, the Filing slip and

folder tab views do not display the names of global folders. When the

globalFoldersOnly

slot holds the value

true

, the Filing slip and folder tab

views do not display the names of local folders.

W A R N I N G

The

localFoldersOnly

and

globalFoldersOnly

must not

both hold non-

nil

values at the same time.

Adding and Removing Filing Categories Programmatically

15

You can use the

AddFolder

and

RemoveFolder

global functions to modify the

set of folders (filing categories) available to your application. Note that the

RemoveFolder

function does not remove any folder that is also used by other

applications. For more information, see the descriptions of these methods in the

Newton Programmer’s Reference

.

Interface to User-Visible Folder Names

15

Symbols that represent folders are not tied to the strings that represent those folders
to the user. As a result, you can use the same folder symbol everywhere for a
particular concept, such as a business, while varying the user-visible string
representing that folder; for example the user-visible string could be localized for
various languages.

You can use the

GetFolderStr

function to retrieve the user-visible string

associated with a folder symbol.