SetInternationalHRC
2.0
Sets the
country, language, and script direction into a recognition context HRC.
int SetInternationalHRC( HRC hrc, UINT
uCountry, LPCSTR lpszLangCode, UINT fuFlags,
UINT uDir )
Parameters
hrc
Handle to the
HRC object.
uCountry
The country
code. A value of 0 indicates that this value should not be set.
lpszLangCode
A
three-letter, null-terminated string identifying the language (for example,
enu or fra ), or NULL. A value of NULL indicates that the language code
should not be changed. For a list of three-letter language identifiers, refer
to Volume 1 of the Programmers Reference in the Windows Software
Development Kit.
fuFlags
Flags. can be
either SIH_ALLANSICHAR to indicate the user intends to use the entire ANSI
character set, or 0.
uDir
The script
direction. This parameter specifies which primary and secondary writing
directions to set. The default directions are left to right for the primary
direction and top to bottom for the secondary. A value of 0 indicates that the
writing direction should not be changed. Possible values for uDir are:
|
Constant |
Description |
|
SSH_RD |
Left to
right and down (English). |
|
SSH_RU |
Left to
right and up. |
|
SSH_LD |
Right to
left and down (Hebrew). |
|
SSH_LU |
Right to
left and up. |
|
SSH_DL |
Down and to
the left (Chinese). |
|
SSH_DR |
Down and to
the right (Chinese). |
|
SSH_UL |
Up and to the
left. |
|
SSH_UR |
Up and to
the right. |
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_UNSUPPORTED |
The
recognizer does not support this function. |
Comments
Setting fuFlags
to the value of SIH_ALLANSICHAR indicates the recognizer should interpret text
written in any language based on ANSI characters. To constrain recognition to a
particular language, an application should set fuFlags to 0 and provide
the appropriate language code in lpszLangCode.
SetInternationalHRC overrides the default ALLANSICHAR setting in the
recognizer set by ConfigHREC
for the life of the HRC object. ConfigHREC should be used to
change the default value.
See Also