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