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

COMException :

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

• Factoid Class
• Improving Tablet PC Recognition Accuracy by Setting Context
• Supported Factoids from Version 1