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);
}
public function get Factoid () : String
public function set Factoid (value : String)
Property Value
Type: System.String
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.
.gif "Security note") 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. |
Examples
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 7, Windows Vista, Windows Server 2008 R2, Windows Server 2008
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information
.NET Framework
Supported in: 3.0