The find APIs are unchanged in Palm OS Cobalt. Card number parameters and fields have been removed where they were once defined. The FindStrInStr()
function has been removed in favor of the TxtFindString()
function. The FindParamsType
structure is now opaque, and the FindMatchType
and GoToParamsType
structures have had new fields added to them.
Note that prior to Palm OS Cobalt you couldn't launch Find when a modal dialog was active. In Palm OS Cobalt you can, so, like any other button tap, launching Find dismisses the currently active dialog by simulating a tap on its default button. As well, in Palm OS releases up to but not including Palm OS Cobalt, the sysAppLaunchCmdFind
launch code is sent to all applications. In Palm OS Cobalt, however, it is only sent to the active application, to all 68K applications, and to those Palm OS Protein applications that have the ALPF_FLAG_NOTIFY_FIND
attribute set to true
in their Application Launch Preferences Resource.
Deleted APIs ^TOP^
Table 44.1 Deleted functions
Deleted API
|
Use instead
|
FindStrInStr()
|
TxtFindString()
|
Table 44.2 Deleted #defines
Deleted API
|
Use instead
|
maxFinds
|
Nothing. This was used in the definition of the FindParamsType structure, the internals of which are now private.
|
Modified APIs ^TOP^
Table 44.3 Modified functions
Modified API
|
Description of change
|
Boolean FindSaveMatch (FindParamsPtr, uint32_t, uint32_t, size_t, size_t, uint32_t, uint32_t, DatabaseID)
|
The card number parameter has been removed, 16-bit fields have been expanded to 32 bits, and an additional parameter has been added to let you specify the length of the matched text.
|
Table 44.4 Modified structures
Modified API
|
Description of change
|
FindMatchType
|
No longer has card number fields (either for the application or for the database in which the record was found). The matchFieldNum field contains a column ID if the match was made in a schema database record. This structure now contains a matchLen field that contains the length, in bytes, of the matched data. Finally, the fields in this structure have been rearranged and additional reserved fields have been added.
|
FindParamsType
|
The contents of this structure are now private and should not be accessed by applications.
|
GoToParamsType
|
No longer has a card number field (dbCardNo ). New fields have been added for the unique ID of the record that contains the match, the length of the matched text, and a string buffer containing the matched text itself. Also, the fields in this structure have been rearranged and additional reserved fields have been added for padding and alignment purposes.
|
Table 44.5 Modified #defines
Modified API
|
Description of change
|
#define maxFindStrLen 48
|
Was 16.
|
Unchanged APIs ^TOP^
Table 44.6 Unchanged functions
Find()
|
FindDrawHeader()
|
FindGetLineBounds()
|
|
Table 44.7 Unchanged types
FindMatchPtr
|
FindParamsPtr
|
GoToParamsPtr
|
|