ALC_ Alphabet Codes
The ALC_ constants enable a subset of the active character set, depending on
the current language.
For example, the French language includes "h" in the lowercase alphabet. In
the same way, "£" replaces "$" if ALC_MONETARY is set in British systems. For
more information about alphabets, see "Specifying an Alphabet Set" in Chapter 8
and "Alphabet" in Chapter 5.
Comments
The following ALC_ constants are are supported:
Constant
| Description
|
ALC_ALL
| All characters except Japanese characters.
|
ALC_ALPHA
| ALC_LCALPHA | ALC_UCALPHA.
|
ALC_ALPHANUMERIC
| ALC_LCALPHA | ALC_UCALPHA | ALC_NUMERIC.
|
ALC_ASCII
| Seven-bit characters ASCII #20 ASCII #0x7F
|
ALC_DBCS
| Allow double-byte character set (DBCS) variety of single-byte character set
(SBCS).
|
ALC_DEFAULT
| Default value; uses complete set of recognizable char-acters and gestures. The
set of these is defined by the recognizer. It is the set of characters at or
above ALC_SYSMINIMUM that the recognizer can accurately distinguish.
If an application sets ALC_DEFAULT in the HRC object, and the recognizer is an alphanumeric system recognizer, the
recognizer must at least support ALC_SYSMINIMUM as a default. ALC_DEFAULT should be the
same character set as the complete character set for the given language minus
the ALC_OTHER characters.
If an application combines ALC_DEFAULT with other ALC_ values, ALC_DEFAULT is
ignored.
|
ALC_GESTURE
| Gestures.
|
ALC_GLOBALPRIORITY
| Specifies that the global recognition priorities (from Tool Palette) are to be
used during recognition. An application can control its own recognition
priority in a control by clearing this flag and then setting its own priorities in
the HRC.
|
ALC_HIRAGANA
| Hiragana characters. (Japanese version only.)
|
ALC_JIS1
| All Kanji Shift JIS level 1 characters. (Japanese version only.)
|
ALC_KANJI
| Kanji characters, Shift JIS levels 1, 2, and 3. (Japanese version only.)
|
ALC_KANJIALL
| ALC_ALL | ALC_HIRAGANA | ALC_KATAKANA | ALC_KANJI. (Japanese version only.)
|
ALC_KANJISYSMINIMUM
| Minimum set of characters needed for Japanese system recognizer. Same as
ALC_SYSMINIMUM | ALC_HIRAGANA | ALC_KATAKANA | ALC_JIS1. (Japanese version only.)
|
ALC_KATAKANA
| Katakana characters. (Japanese version only.)
|
ALC_LCALPHA
| Lowercase letters az.
|
ALC_MATH
| Math symbols: %^*()-+={}<>,/.
|
ALC_MONETARY
| Monetary symbols: ,.$ or appropriate currency desig-nation such as the yen or
pound sterling symbol, accord-ing to the current language setting.
|
ALC_NONPRINT
| Space, tab, carriage-return, and control glyphs.
|
ALC_NOPRIORITY
| No priority. This value means the application has no preference for one type
of symbol over another.
|
ALC_NUMERIC
| Numerals 09.
|
ALC_OEM
| Bits reserved for recognizer capabilities specific to the original equipment
manufacturer (OEM).
|
ALC_OTHER
| Other symbols: @ # | _ ~ [ ]. That is, all other symbols not included in
ALC_ALPHANUMERIC, ALC_MONETARY, ALC_MATH, and ALC_PUNC.
|
ALC_PUNC
| Punctuation: !-;`"?()&.,\.
|
ALC_RESERVED
| Reserved.
|
ALC_SYSMINIMUM
| Minimum set of characters needed for Roman alphabet system recognizers:
ALPHANUMERIC | ALC_PUNC | ALC_WHITE | ALC_GEST.
|
ALC_UCALPHA
| Uppercase letters AZ.
|
ALC_USEBITMAP
| (Description follows table.)
|
ALC_WHITE
| White space. If this value is not set in the HRC object, the recognizer should ignore any white space left between characters.
Thus, ALC_WHITE is included in the ALC_DEFAULT. For example, in the zip code
field of the Hform sample application, where ALC_NUMERIC | ALC_GESTURE is set,
the user does not have to worry about getting any extraneous spaces.
|
If ALC_USEBITMAP is set, it indicates the recognizer should adopt an alphabet
set defined by the application. The defined set specifies individual characters
of an alphabet by setting bits in a 256-bit bitfield. The lowest bit
corresponds to the first character of the alphabet, the second bit to the second
character, and so forth.
An application passes the bitfield to a recognizer through the
SetAlphabetHRC or
SetBoxAlphabetHRC functions. The following code shows how. Assume the array rgbfSet holds the desired bit values.
HRC hrc; // HRC handle
BYTE rgbfSet[cbRcrgbfAlcMax] // 256-bit bitfield
SetAlphabetHRC( hrc, ALC_USEBITMAP, (LPBYTE) rgbSet );
ALC_USEBITMAP can be combined with other ALC_ values using the bitwise-OR
operator. An application can thus, for example, select certain letters with a
defined bitmap and combine them with all numerals and punctuation.
For Asian languages other than Japanese, refer to the appropriate subsets
within the language: phonetic symbols for words within the language, phonetic
symbols for words outside the language, and native pictographs. For example, in
Korean, ALC_HANGUEL equals ALC_KATAKANA, and ALC_HANJA equals ALC_KANJI.
For kanji and other Asian encodings, different effects are possible depending
on the state of ALC_DBCS. These effects are described in the following table.
Character in
| ALC_DBCS = 0
| ALC_DBCS = 1
|
ALC_HIRAGANA
| N/A
| Shift JIS characters 0x8154, 0x8155, and 0x829F 0x82F1.
|
ALC_JIS1
| N/A
| All Kanji Shift JIS level 1 characters.
|
ALC_KATAKANA
| 0xA1 - 0xDF
| Shift JIS characters 0x814A, 0x814B, 0x8152, 0x8153, 0x815B, and 0x8340 0x8396.
|
ALC_KANJI
| N/A
| All Kanji characters, Shift JIS levels 1, 2, and 3.
|
The following table shows the characters in Shift-JIS in each ALC_ set
supported in the Japanese version:
ALC_ value
| Shift JIS Code
|
ALC_HIRAGANA
| 0x8154, 0x8155, and 0x829F 0x82F1
|
ALC_JIS1
| 0x8156 0x815A, 0x889F 0x9872
|
ALC_KANJI
| 0x8156 0x815A, 0x889F 0xEAA4, 0xED40 0xEDFC, 0xEE40 0xEEFC, 0xF040 0xF9FC, 0xFAF0 0xFAFC, 0xFB40 0xFBFC, 0xFC40 0xFC4B
|
ALC_KATAKANA
| 0x814A, 0x814B, 0x8152, 0x8153, 0x815B, 0x8340 0x8396
|
ALC_LCALPHA
| 0x8281 0x829A
|
ALC_MATH
| 0x8143, 0x8144, 0x814F, 0x815E, 0x8169, 0x816A, 0x816F, 0x8170, 0x817B 0x817E, 0x8180 0x8188, 0x8193, 0x8196
|
ALC_MONETARY
| 0x8143, 0x8144, 0x818F 0x8192
|
ALC_NONPRINT
| 0x8140
|
ALC_NUMERIC
| 0x824F 0x8258
|
ALC_OTHER
| 0x814C 0x814E, 0x8150, 0x8151, 0x8160 0x8164, 0x816B, 0x816C, 0x8171 0x8174, 0x8179, 0x817A, 0x817F, 0x8189 0x818E, 0x8194, 0x8197 0x81FC, 0x8240 0x824E, 0x8259 0x825F, 0x827A 0x8280, 0x829B 0x829E, 0x82F2 0x82FC, 0x837F, 0x897 0x83FC, 0x8840 0x84FC, 0x8740 0x879D
|
ALC_PUNC
| 0x8141 0x8149, 0x815B 0x815F, 0x8165 0x816A, 0x816D 0x8170, 0x8175 0x8178, 0x817C, 0x8195
|
ALC_UCALPHA
| 0x8260 0x8279
|
ALC_WHITE
| 0x8140
|
A recognizer must not return a symbol value outside the specified subset.
However, a recognizer does not have to force a match to the subset; it can instead
return "unknown" if a suitable match is not found.
You can set the ALC_ value for an hedit or bedit control in a dialog box by
insert-ing a special string in the .RC file's CONTROL statement. This string is
in the form ALC<
xxxx> where
xxxx represents a case-independent hexadecimal ALC_ code, without a preceding 0x
qualifier. You can append normal window text after the ALC_ entry.
The following line demonstrates setting the ALC_ value for an hedit control
using a CONTROL statement:
CONTROL "ALC<402C>Dollars", IDD_PAID, "hedit", ES_LEFT | ... etc.
In the above example, the ALC<402C> value is stripped out with "Dollars" left as window text. The number 402C is
the hexadecimal equivalent of:
ALC_NUMERIC | ALC_PUNC | ALC_MONETARY | ALC_GESTURE
The following example allows only kanji characters, katakana characters, and
gestures; it does not specify initial window text:
CONTROL "ALC<74000>", IDD_J, "hedit", ES_LEFT | ... etc.
- Software for developers
-
Delphi Components
.Net Components
Software for Android Developers
- More information resources
-
MegaDetailed.Net
Unix Manual Pages
Delphi Examples
