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

C H A P T E R 1 0
Recognition: Advanced Topics
10-18 Using Advanced Topics in Recognition
▲
W A R N I N G
The SetValue function may not be appropriate for
setting the entryFlags slot in views that do not
have a viewFlags slot. In these kinds of views, set the
value of the entryFlags slot directly and then call the
PurgeAreaCache function to invalidate the area cache. If you
have changed values in the system’s user configuration data, call
the
ReadCursiveOptions function instead of the
PurgeAreaCache function. ▲
You can also use the PurgeAreaCache function to invalidate the area cache. This
function provides an efficient way to force the reconstruction of recognition areas
after you’ve changed the values of slots in multiple views. Note, however, that this
function does not resynchronize the recognition system with changes in the
system’s user configuration data. Do not call
PurgeAreaCache to effect changes
in user preferences for recognition.
User preferences that affect recognition behavior are saved as slot values in the
system’s user configuration data. Some of these values, such as that of the
timeoutCursiveOption slot, affect all views; others affect only views that set
the vAnythingAllowed mask. For detailed information about the slot you need
to set, see its description in “System-Wide Settings” (page 8-2) in Newton
Programmer’s Reference.
When setting user preferences for recognition, do not modify the system’s user
configuration data directly. Instead, use the
GetUserConfig and
SetUserConfig global functions to manipulate user configuration values.
After calling the SetUserConfig function to set one or more new values, you
must call the ReadCursiveOptions function to cause the recognition system to
use the new values. Do not call the PurgeAreaCache function after changing
values in the system’s user configuration data—this function does not even test for
changes to user preferences. Because the
ReadCursiveOptions function
invalidates the area cache, you need not call the PurgeAreaCache function after
calling the ReadCursiveOptions function.
IMPORTANT
The view’s viewFlags slot must contain the same recognition
flags as the inputMask slot in its recConfig frame. Certain
view system operations depend on the viewFlags slot being set
up properly. ▲