Filing

About Filing

Filing Compatibility Information

15

Version 2.0 of the Newton operating system supports earlier versions of the Filing
interface completely--no code modifications are required for older filing code to
continue working under the version 2.0 operating system. However, it is strongly
suggested that you update your application to the version 2.0 Filing interface to
take advantage of new features and to remain compatible with future versions of
the Newton operating system. This section provides version 2.0 compatibility
information for applications that use earlier versions of the Filing interface.

Users can now create folders visible only to a specified application; the folders are
said to be local to that application. Folders created using previous versions of the
Filing interface are visible to all applications when first read on a 2.0-based system.
Applications can now filter the display of items according to the store on which
they reside and according to whether they are filed in local or global folders.

The symbols that represent folders are no longer tied to the strings that represent
them to the user, as they were in previous versions of the Newton operating system.
This new scheme allows you to 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.

Applications can now route items directly to a specified store from the Filing slip.
In addition, registration for notification of changes to folder names has been
simplified.

The

protoFolderTab

proto is replaced by the

protoNewFolderTab

and

protoClockFolderTab

protos.

The

protoFilingButton

proto now supplies its own borders. You do not need

to enclose the filing button in another view to produce a border around the button.

The

FolderChanged

and

FilingChanged

methods are obsolete. They are

replaced by the

FileThis

method and the folder change notification mechanism.

If your application supplies a

FileThis

method, the system does not send

FolderChanged

and

FilingChanged

messages to your application. Instead of

supplying a

FolderChanged

method, your application should register a callback

function with the folder change notification mechanism to perform tasks when the
user adds, deletes, or edits folders.

The

FilterChanged

method is obsolete; your application should supply a

NewFilingFilter

method instead. Your

NewFilingFilter

method must

update the query that retrieves items matching the current filing category and
perform any other actions that are appropriate, such as redrawing views affected by
the change of filing filter. If your application supplies a

NewFilingFilter

method, the system does not send

FilterChanged

messages to your application.