PenInputPanel.Factoid Property

Deprecated. Gets or sets the string name of the factoid used by the PenInputPanel object. PenInputPanel has been replaced by Microsoft.Ink.TextInput.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in microsoft.ink.dll)

Syntax

'Declaration
Public Property Factoid As String
'Usage
Dim instance As PenInputPanel
Dim value As String

value = instance.Factoid

instance.Factoid = value

public string Factoid { get; set; }

public:
property String^ Factoid {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_Factoid ()

/** @property */
public void set_Factoid (String value)

public function get Factoid () : String

public function set Factoid (value : String)

Not applicable.

Property Value

The name of the factoid used by the PenInputPanel object.

Value	Meaning
DEFAULT	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.

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 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 locales that use recognizers of Latin script, all factoids may be used. In locales that use recognizers of East Asian language characters, 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.

Security Note:
If using under partial trust, this property requires SecurityPermissionFlag.AllFlags permission, in addition to the permissions required by PenInputPanel. See Security and Trust for more information.

Example

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.

[C#]

// 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;

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.

[Visual Basic]

' 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

Platforms

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Framework

Supported in: 3.0

See Also

Reference

PenInputPanel Class
PenInputPanel Members
Microsoft.Ink Namespace
Factoid

Other Resources

Supported Factoids from Version 1