AddPenDataHRC

2.0

Adds an HPENDATA object to an HRC object for recognition.

int AddPenDataHRC( HRC hrc, HPENDATA hpndt )

Parameters

hrc

Handle to the HRC object.

hpndt

Handle to the HPENDATA object.

Return Value

Returns HRCR_OK if successful; otherwise, returns one of the following negative values:

Constant	Description
HRCR_ERROR	Invalid parameter or other error.
HRCR_MEMERR	Insufficient memory.
HRCR_INVALIDPNDT	Invalid pen data object.

Comments

Before terminating, the application must free the pen data, using DestroyPenData. Because the recognizer copies any data it requires, the recognizer does not affect the original data.

Calling this function is equivalent to adding data to the recognition context by walking the pen data strokes from beginning to end in stroke order. (Note that the stroke order may not necessarily be in chronological order if insertions have been made.)

A recognizer is not required to use or maintain OEM data; that is, a recognizer may choose to ignore some or all of the OEM data it receives from AddPenDataHRC. This means that the HPENDATA object that the recognizer returns through its CreatePenDataHRC function may differ from hpndt in its OEM data.

See Also

CreatePenData, AddPenInputHRC

Software for developers

Delphi Components
.Net Components
Software for Android Developers

More information resources

MegaDetailed.Net
Unix Manual Pages
Delphi Examples