Passes ink and its symbol interpretation to the recognizer for training.
int TrainHREC( HREC hrec, LPSYV lpsyv, UINT cSyv, HPENDATA hpndt, UINT uConflict )
Module handle of the recognizer library. If this value is NULL, the system
default recognizer is used.
Address of an array of symbols to train.
Count of symbols in lpsyv
. This must be greater than 0.
Handle to an HPENDATA
One of the following TH_ values that specify how to handle training conflicts:
||Query the user if the proposed training conflicts with symbols in the database.
||Perform the training without querying the user, even if there is a conflict
with the database.
||Abandon the training if there is any conflict with the database and return an
Returns HRCR_OK if training is successful; otherwise, returns one of the
following negative values:
||Invalid parameter or other error.
||TH_SUGGEST was specified but there was a conflict with the database. No
training was done.
||Invalid HPENDATA object.
||The recognizer does not support this function.
Typically, an application calls TrainHREC
to train a single symbol. In other words, lpsyv
points to a single symbol that is followed by an SYV_NULL terminator.
However, multiple symbols
for example, those representing the character string "ng"
may also be trainable, depending on the recognizer.
is TH_QUERY, the recognizer is free to prompt the user with a dialog box to
resolve training conflicts. If it is TH_FORCE, the training is performed
regardless of conflicts and the original conflicting data may be lost. TH_SUGGEST
trains the recognizer only if there are no conflicts; otherwise, the call fails and
If the user picks a meaning for some ink from a list of alternatives, such as
in a boxed edit control, the application can elect to train the recognizer with
this information. In this case, either TH_FORCE or TH_SUGGEST is a suitable
value for uConflict
Training gestures depends on the recognizer. The Microsoft Handwriting
Recognizer (GRECO.DLL) does not support training for gestures.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages