background image
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.
© 2007-2017, o7 studio » при воспроизведении материала сайта ссылка обязательна