Apple Newton Utilities Betriebsanweisung PDF herunterladen (Seite 598)

100

101

CHAPTER 16

Find

16-10 Using the Find Service

The most important difference between Local ﬁnds and other kinds of ﬁnd

operations is that when the system invokes your search method as part of a Global

or Selected ﬁnd, your application may not be open. Therefore, you must test to see

that the application soup is available before searching it.

The system informs your search method of the scope of the search through the

scope

parameter. You can choose to ignore it or you can modify your application’s

actions based on whether the value of this parameter is

'localFind or

'globalFind. The system passes the 'globalFind symbol when it invokes

your search method for a Global or Selected ﬁnd. The

'localFind symbol is

passed for Local ﬁnd operations.

Checklist for Adding Find Support 16

To add application support for the Find service, you need to do the following:

■ Create a title slot, in the view referenced by the owner slot of your ﬁnder

frame, that contains the user-visible name of the application.

■ Create the appName slot in your application’s base view that contains the user-

visible name of the application.

■ Choose a ﬁnder proto on which to base your application’s frame. You should

use

ROM_SoupFinder if your data is stored in a single soup, and

ROM_CompatibleFinder otherwise.

■ Supply at least one search method (Find, DateFind).

■ Append the resultant ﬁnder frame to the system-supplied results array at the

end of your search method(s).

■ Supply a FindSoupExcerpt method that extracts strings from soup entries for

display in the Find overview. This method is required only if you use the

ROM_SoupFinder proto. If you use the ROM_CompatibleFinder proto you

must add a

title slot with a string deﬁning each found item to the frame

representing the item.

■ Supply a ShowFoundItem method that displays an individual entry from the

found items.

■ When using a ROM_CompatibleFinder proto, write a ShowFakeEntry

method to call your

ShowFoundItem method.

■ When using the ROM_CompatibleFinder, you should either not allow

your found items to be selected (and thus not routed), or override the relevant

routing methods.

Optionally, you may also do the following:

■ Register and unregister for participation in Global and Selected ﬁnds.

1 2 ... 593 594 595 596 597 598 599 600 601 602 603 ... 941 942

Kommentare zu diesen Handbüchern

Keine Kommentare

Apple Newton Utilities Betriebsanweisung Seite 598

Kommentare zu diesen Handbüchern

Verwandte Produkte und Handbücher für Software Apple Newton Utilities