Factoid Constants
Defines constant string values that are used to increase recognition accuracy by providing contextual information to the recognizer.
| Name | Description |
|---|---|
|
Disables all other factoids and dictionaries. |
|
The Default setting for factoids for western languages includes the system dictionary, user dictionary, various punctuations, and the Web and Number factoid. The Default setting for factoids for East Asian languages includes all characters supported by the recognizer. |
|
Indicates to a recognizer to use the system dictionary only. |
| 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 |
Indicates to a recognizer to look for an email address. Note: A fully qualified email address, such as "someone@example.com", must be used for this factoid. A lone alias, such as "someone", is not recognized. |
|
Indicates to a recognizer to look for a Web address. |
| FACTOID_ONECHAR |
Indicates to a recognizer to look for a single character. Note: This factoid looks for any isolated ANSI character. |
| FACTOID_NUMBER |
Indicates to a recognizer to look for a number. Note: Numeric values include separators, decimals, ordinals and other commonly used numeric symbols. |
|
Indicates to a recognizer to look for a single digit, 0 through 9. |
| FACTOID_NUMBERSIMPLE |
Provides a simple numeric context to a recognizer. Note: This factoid is not supported in this version of the Tablet PC SDK. |
|
Indicates to a recognizer to look for characters that denote a currency value. |
|
Indicates to a recognizer to look for postal codes. |
|
Indicates to a recognizer to look for percentages. |
|
Indicates to a recognizer to look for characters that denote a date. |
|
Indicates to a recognizer to look for characters that denote a time. |
|
Indicates to a recognizer to look for characters that denote a telephone number. |
|
Indicates to a recognizer to look for characters that denote a file name. |
|
Indicates to a recognizer to look for a single uppercase character: A through Z. |
| FACTOID_LOWERCHAR |
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 |
Indicates to a recognizer to look for punctuation characters. Note: This factoid is not supported in this version of the Tablet PC SDK. |
|
Indicates to a recognizer to look for commonly used Kanji, Katakana, and Hiragana characters. |
|
Indicates to a recognizer to look for commonly used Simplified Chinese characters. |
|
Indicates to a recognizer to look for commonly used Traditional Chinese characters. |
|
Indicates to a recognizer to look for commonly used Korean characters. |
|
Indicates to a recognizer to look for Hiragana characters only. |
|
Indicates to a recognizer to look for Katakana characters only. |
|
Indicates to a recognizer to look for commonly used kanji characters. |
| FACTOID_KANJIRARE |
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. |
|
Indicates to a recognizer to look for Bopomofo characters. |
|
Indicates to a recognizer to look for Hangul compatibility Jamo characters. |
|
Indicates to a recognizer to look for commonly used Hangul characters. |
| FACTOID_HANGULRARE |
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
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 COM Library.
Note
For recognizers of Latin script, 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 SetInputScope function. For details, see Using Context to Improve Accuracy.
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 an 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 Using Context to Improve Accuracy. To determine whether a factoid is available in a specific language, see Supported Factoids from Version 1.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows XP Tablet PC Edition [desktop apps only] |
| Minimum supported server |
None supported |
| Header |
|
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for