Factoid Constants
Factoid Constants |
Defines constant string values that are used to increase recognition accuracy by providing contextual information to the recognizer.
C++
In C++, you can access these constants in the Msinkaut.h header file, which is located in the <systemdrive>:\Program Files\Microsoft Tablet PC Platform SDK\Include directory if you installed the SDK in the default location.
Note: These constants are WCHARs, not BSTRs. They must be converted into BSTRs before use as parameters to object methods. For more information about the BSTR data type, see Using the Automation Library.
Visual Basic 6.0
In Microsoft® Visual Basic® 6.0, these constants are defined in the InkConstants.bas file, which is located in the <systemdrive>:\Program Files\Microsoft Tablet PC Platform SDK\Include directory if you installed the SDK in the default location.
Constants
| C++ Name | Visual Basic 6.0 Name | Definition | Examples |
|---|---|---|---|
| FACTOID_NONE | FactoidNone | Disables all other factoids and dictionaries. | |
| FACTOID_DEFAULT | FactoidDefault | The Default setting for factoids for western languages includes the system dictionary, user dictionary, various punctuations, and the Web and Number factoids. The Default setting for factoids for East Asian languages includes all characters supported by the recognizer. | |
| FACTOID_SYSTEMDICTIONARY | FactoidSystemDictionary | Indicates to a recognizer to use the system dictionary only. | |
| FACTOID_WORDLIST | Factoid_WordList | Indicates to a recognizer to use a programmatically-defined list of words. The list of words is defined by the WordList property of a InkRecognizerContext object.
Note: If a string is added to a word list, its capitalized versions are also implicitly added. For instance, adding "hello" implicitly adds "Hello" and "HELLO".
|
|
| FACTOID_EMAIL | FactoidEmail | Indicates to a recognizer to look for an e-mail address.
Note: A fully qualified e-mail address, such as "someone@example.com", must be used for this factoid. A lone alias, such as "someone", is not recognized.
|
someone@example.com |
| FACTOID_WEB | FactoidWeb | Indicates to a recognizer to look for a web address. | https://www.adatum.com |
| FACTOID_ONECHAR | FactoidOneChar | Indicates to a recognizer to look for a single character.
Note: This factoid looks for any isolated ANSI character.
|
|
| FACTOID_NUMBER | FactoidNumber | Indicates to a recognizer to look for a number.
Note: Numeric values includes separators, decimals, ordinals and other commonly used numeric symbols.
|
|
| FACTOID_DIGIT | FactoidDigit | Indicates to a recognizer to look for a single digit, 0 through 9. | 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 |
| FACTOID_NUMBERSIMPLE | FactoidNumberSimple | Provides a simple numeric context to a recognizer.
Note: This factoid is not supported in this version of the Tablet PC SDK.
|
|
| FACTOID_CURRENCY | FactoidCurrency | Indicates to a recognizer to look for characters that denote a currency value. | $45.95, €60, £50.25, ¥3000 |
| FACTOID_POSTALCODE | FactoidPostalCode | Indicates to a recognizer to look for postal codes. | 98112 |
| FACTOID_PERCENT | FactoidPercent | Indicates to a recognizer to look for percentages. | 87% |
| FACTOID_DATE | FactoidDate | Indicates to a recognizer to look for characters that denote a date. | 10/30/2001, '01, 31/12, 12/99, 1999-2000 |
| FACTOID_TIME | FactoidTime | Indicates to a recognizer to look for characters that denote a time. | 12:23:00 PM, 12:30, 24:30, 12:23:01, 1:12 A.M. |
| FACTOID_TELEPHONE | FactoidTelephone | Indicates to a recognizer to look for characters that denote a telephone number. | 123 555 0190, 0-123-206 555 0190, (206)555-0190 |
| FACTOID_FILENAME | FactoidFilename | Indicates to a recognizer to look for characters that denote a file name. | mydocument.doc, c:\myfolder\file.c |
| FACTOID_UPPERCHAR | FactoidUpperChar | Indicates to a recognizer to look for a single uppercase character: A through Z. |
|
| FACTOID_LOWERCHAR | FactoidLowerChar | Indicates to a recognizer to look for a single lowercase character: A through Z.
Note: This factoid is not supported in this version of the Tablet PC SDK.
|
|
| FACTOID_PUNCCHAR | FactoidPuncChar | Indicates to a recognizer to look for punctuation characters.
Note: This factoid is not supported in this version of the Tablet PC SDK.
|
|
| FACTOID_JAPANESECOMMON | FactoidJapaneseCommon | Indicates to a recognizer to look for commonly used Kanji, Katakana, and Hiragana characters. | |
| FACTOID_CHINESESIMPLECOMMON | FactoidChineseSimpleCommon | Indicates to a recognizer to look for commonly used Simplified Chinese characters. | |
| FACTOID_CHINESETRADITIONALCOMMON | FactoidChineseTraditionalCommon | Indicates to a recognizer to look for commonly used Traditional Chinese characters. | |
| FACTOID_KOREANCOMMON | FactoidKoreanCommon | Indicates to a recognizer to look for commonly used Korean characters. | |
| FACTOID_HIRAGANA | FactoidHiragana | Indicates to a recognizer to look for Hiragana characters only. | |
| FACTOID_KATAKANA | FactoidKatakana | Indicates to a recognizer to look for Katakana characters only. | |
| FACTOID_KANJICOMMON | FactoidKanjiCommon | Indicates to a recognizer to look for commonly used kanji characters. | |
| FACTOID_KANJIRARE | FactoidKanjiRare | Indicates to a recognizer to look for rarely used kanji characters.
Note: This factoid is not supported in this version of the Tablet PC SDK.
|
|
| FACTOID_BOPOMOFO | FactoidBopomofo | Indicates to a recognizer to look for Bopomofo characters. | |
| FACTOID_JAMO | FactoidJamo | Indicates to a recognizer to look for Hangul compatibility Jamo characters. | |
| FACTOID_HANGULCOMMON | FactoidHangulCommon | Indicates to a recognizer to look for commonly used Hangul characters. | |
| FACTOID_HANGULRARE | FactoidHangulRare | Indicates to a recognizer to look for rarely used Hangul characters.
Note: This factoid is not supported in this version of the Tablet PC SDK.
|
Remarks
Note: For Western recognizers, the factoids defined in this class are provided for backward compatibility only. For new development, you are encouraged to use the values defined in the InputScope enumeration. For details, see Improving Tablet PC Recognition Accuracy by Setting Context.
Use these identifiers to specify which factoid should be used during recognition.
The following combinations of factoids are supported for western languages only. These do not have separate definitions, but are acceptable string literal inputs to the Factoid property of objects that use factoids. These factoid string constants allow the input to match any of the factoids in the expression.
| Combination | Definition |
|---|---|
| "WEB|WORDLIST" | The Web factoid or the word list. |
| "EMAIL|WORDLIST" | The Email factoid or the word list. |
| "FILENAME|WEB|WORDLIST" | The Filename factoid or the Web factoid or the word list. |
If you are using the InkEdit control, the factoid can be set as a property of the control.
If you are using the Tablet PC Platform APIs, you can set the Factoid property on a InkRecognizerContext object.
Alternatively, you can set this property with the actual factoid string constant.
Note: Factoid string constants are case sensitive. For more information about factoids and how to use them, see Improving Tablet PC Recognition Accuracy by Setting Context. To determine whether a factoid is available in a specific language, see Supported Factoids from Version 1.