Recognition: Advanced Topics

Using Advanced Topics in Recognition

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.

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.