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

C H A P T E R 1 5
Filing
About Filing 15-9
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.