Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 1 - Newton Works / Newton Works Interface Reference

Newton Works DataDef Slots and Methods /

FindFn

dataDef:FindFn(entry, what, offset)

Called by Newton Works when a global (Newton-wide) Find is performed, and a search using the function FindStringInFrame finds nothing in a Newton Works soup entry.

entry

The soup entry to search.

what

The string to search for.

offset

An integer specifying an offset, in characters. Begin searching in entry starting at this offset.

return value

Return non-nil from this method if the string what is found in the entry anywhere after offset. Return nil if the string is not found.

DISCUSSION

This method should search the soup entry for the what string.

Note that if the string is in the soup entry in plain NewtonScript string form (if FindStringInFrame returns true) *FindFn will not be called because Newton Works has already identified the entry as matching the Find criteria. The *FindFn method is called only when FindStringInFrame finds nothing, to let you do any custom processing that might be needed in order to do a string search.