PenInputPanel.Factoid Property
PenInputPanel.Factoid Property |
Gets or sets the string name of the factoid used by the PenInputPanel object.
Definition
Visual Basic .NET Public Property Factoid As String C# public string Factoid { get; set; } Managed C++ public: __property String* get_Factoid();
public: __property void set_Factoid(String*);
Property Value
System.String. The name of the factoid used by the PenInputPanel object.
This property is read/write. This property has no default value.
Exceptions
Remarks
A factoid provides a recognizer context for ink within a particular field. You specify a factoid if an input field is of a known type. For example, if the input field contains a date, specify the Date factoid.
The Factoid property takes or returns a String
, not a Factoid object. For a list of possible values for the Factoid property, see Supported Factoids from Version 1.
For more information about factoids and how to use them, see Improving Tablet PC Recognition Accuracy by Setting Context. For a list of supported factoids, see the Factoid object and Supported Factoids from Version 1.
Note: String representations of factoids are case-sensitive.
This property has no effect on keypads or keyboards.
The WordList factoid is not supported for the PenInputPanel object.
The default value for the Factoid property is Default. In Latin language locales, all factoids may be used. In East Asian language locales, the following factoid values are relevant:
- Digit implies the Num bias button on the East Asian writing pad
- OneChar implies the Alpha bias button on the East Asian writing pad
- Common factoids (JapaneseCommon, ChineseSimpleCommon, ChineseTraditionalCommon, KoreanCommon, KanjiCommon, and HangulCommon) imply the Alpha/Num bias button on the East Asian writing pad
All factoid values other than Digit and OneChar are interpreted as the common factoid that is appropriate for the current input locale.
If the Factoid property is set, it is forwarded to the recognizer only if the SetInputScope function has not also been called.
Examples
[C#]
This C# example creates a PenInputPanel object, thePenInputPanel, and attaches it to an InkEdit control, theInkEdit. It then sets the Factoid property of a recognizer context to bias recognition toward numbers.
// Declare, create, and attach a new PenInputPanel object to an InkEdit control PenInputPanel thePenInputPanel = new PenInputPanel(theInkEdit); // Set the PenInputPanel object to bias recognition toward numbers thePenInputPanel.Factoid = Factoid.Digit;[Visual Basic .NET]
This Microsoft® Visual Basic® .NET example creates a PenInputPanel object, thePenInputPanel, and attaches it to an InkEdit control, theInkEdit. It then sets the Factoid property of a recognizer context to bias recognition toward numbers.
' Declare, create, and attach a new PenInputPanel to an InkEdit control Dim thePenInputPanel As New PenInputPanel(theInkEdit) ' Set the PenInputPanel object to bias recognition toward numbers thePenInputPanel.Factoid = Factoid.Digit
See Also