RECO_ATTRS Structure

RECO_ATTRS Structure

Retrieves the attributes of a recognizer or specifies which attributes to use when you search for an installed recognizer.

Declaration

[C++]

typedef struct tagRECO_ATTRS
{
  DWORD dwRecoCapabilityFlags;
  WCHAR awcVendorName[MAX_VENDORNAME];
  WCHAR awcFriendlyName[MAX_FRIENDLYNAME];
  WORD awLanguageId[MAX_LANGUAGES];
} RECO_ATTRS;

Members

Name Capability flag Description
dwRecoCapabilityFlags The following flags specify the capabilities of the recognizer. You can set these flags when you search for a recognizer if the awcFriendlyName member is empty, and you specify a value for the awLanguageId member.
  RF_DONTCARE (1) If set, the recognizer ignores all other capability flag settings.
  RF_OBJECT (2) If set, the recognizer performs object recognition; otherwise, the recognizer performs text recognition.
  RF_FREE_INPUT (4) The recognizer supports free input.

Free input does not require the use of a RECO_GUIDE structure for recognition. Ink is entered without the use of a guide, as opposed to entering ink with lined or boxed input.

  RF_LINED_INPUT (8) The recognizer supports lined input, which is similar to writing on lined paper.

Lined input requires the use of a structure for recognition.

  RF_BOXED_INPUT (16) The recognizer supports boxed input. Each character or word is entered in a box.

Boxed input requires the use of a structure for recognition.

  RF_CAC_INPUT (32) The recognizer supports character Autocomplete. Recognizers that support character Autocomplete require boxed input.
  RF_RIGHT_AND_DOWN (64) The recognizer supports western and East Asian languages.
  RF_LEFT_AND_DOWN (128) The recognizer supports Hebrew and Arabic languages.
  RF_DOWN_AND_LEFT (256) The recognizer supports East Asian languages.
  RF_DOWN_AND_RIGHT (512) The recognizer supports the Chinese language.
  RF_ARBITRARY_ANGLE (1024) The recognizer supports text written at arbitrary angles.
  RF_LATTICE (2048) The recognizer can return a lattice object.
  RF_ADVISEINKCHANGE (4096) If set, the recognizer implements the AdviseInkChange function.
  RF_STROKEREORDER (8192) The recognizer supports stroke re-ordering.
awcVendorName   Vendor who wrote the recognizer.
awcFriendlyName   A human-readable name for the recognizer.

Specify this name when you search for an installed recognizer.

awLanguageId   List of language and sublanguage combinations that the recognizer supports. The list is NULL-terminated.

Specify language identifiers when you search for an installed recognizer if the awcFriendlyName member contains an empty string. Use the MAKELANGID macro to create the language identifiers. If the recognizer does not distinguish between writing styles corresponding to different sublanguages, specify SUBLANG_NEUTRAL for the sublanguage identifier.