Factoid Constants

Defines constant string values that are used to increase recognition accuracy by providing contextual information to the recognizer.

Name Description
FACTOID_NONE
Disables all other factoids and dictionaries.
FACTOID_DEFAULT
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.
FACTOID_SYSTEMDICTIONARY
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.

someone@example.com
FACTOID_WEB
Indicates to a recognizer to look for a Web address.
https://www.adatum.com
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.

FACTOID_DIGIT
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
Provides a simple numeric context to a recognizer.
[!Note]
This factoid is not supported in this version of the Tablet PC SDK.

FACTOID_CURRENCY
Indicates to a recognizer to look for characters that denote a currency value.
$45.95,  60,  50.25,  3000
FACTOID_POSTALCODE
Indicates to a recognizer to look for postal codes.
98112
FACTOID_PERCENT
Indicates to a recognizer to look for percentages.
87%
FACTOID_DATE
Indicates to a recognizer to look for characters that denote a date.
10/30/2001, '01, 31/12, 12/99, 1999-2000
FACTOID_TIME
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
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
Indicates to a recognizer to look for characters that denote a file name.
mydocument.doc, c:\myfolder\file.c
FACTOID_UPPERCHAR
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.

FACTOID_JAPANESECOMMON
Indicates to a recognizer to look for commonly used Kanji, Katakana, and Hiragana characters.
FACTOID_CHINESESIMPLECOMMON
Indicates to a recognizer to look for commonly used Simplified Chinese characters.
FACTOID_CHINESETRADITIONALCOMMON
Indicates to a recognizer to look for commonly used Traditional Chinese characters.
FACTOID_KOREANCOMMON
Indicates to a recognizer to look for commonly used Korean characters.
FACTOID_HIRAGANA
Indicates to a recognizer to look for Hiragana characters only.
FACTOID_KATAKANA
Indicates to a recognizer to look for Katakana characters only.
FACTOID_KANJICOMMON
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.

FACTOID_BOPOMOFO
Indicates to a recognizer to look for Bopomofo characters.
FACTOID_JAMO
Indicates to a recognizer to look for Hangul compatibility Jamo characters.
FACTOID_HANGULCOMMON
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 :\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

Minimum supported client
Windows XP Tablet PC Edition [desktop apps only]
Minimum supported server
None supported
Header
Msinkaut.h (also requires Msinkaut_i.c)

See also

Factoid Property [InkRecognizeContext Class]

Factoid Property [PenInputPanel Class]

Factoid Property [InkEdit Control]

Using Context to Improve Accuracy

Supported Factoids from Version 1