InkEdit.property

Description

Properties that control the behavior of a column with the InkEdit edit style.

Applies to

Column controls

Syntax

DataWindow .NET dot notation:

(( InkEdit) colname.EditStyle).property [C#]
CType(colname.EditStyle, InkEdit).property [Visual Basic]

Describe and Modify argument:

"columnname.InkEdit.property { = value }"

Parameter	Description
columnname	The name of a column that has the InkEdit edit style.
property	A property for the InkEdit column. Properties and their settings are listed in the table below.
value	The value to be assigned to the property.

Property for InkEdit	Value
AutoSelect	Whether to select the contents of the edit control automatically when it receives focus. Values are: Yes – Select automatically (default). No – Do not select automatically. You can use AutoSelect with DataWindowSyntaxFromSql. The setting applies to all the columns in the generated syntax.
DisplayOnly	Specifies whether the text is display-only and cannot be changed by the user. Values are: true – Text cannot be changed by user. false – Text can be changed by user (default).
Factoid	Specifies a context for ink recognition. Set this property if the input data is of a known type, such as a date or Web address, to constrain the search for a recognition result. Possible values include digit, e-mail, Web, date, time, number, currency, percent, and telephone. For a list of values, see the table that follows.
FocusRectangle	Whether a dotted rectangle (the focus rectangle) will surround the current row of the column when the column has focus. Values are: Yes – (Default) Display the focus rectangle. No – Do not display the focus rectangle (default). You can use FocusRectangle with DataWindowSyntaxFromSql. The setting applies to all the columns in the generated syntax.
HScrollbar	Whether a horizontal scroll bar displays in the edit control. Values are: Yes – Display the horizontal scroll bar. No – Do not display the horizontal scroll bar (default).
InkMode	Specifies whether ink collection is enabled and whether ink only or ink and gestures are collected. Values are: InkDisabled (0) – Ink collection is disabled. CollectInkOnly (1) – Only ink is collected. CollectInkAndGestures (2) – Ink and gestures are collected (default).
Limit	A number specifying the maximum number of characters (0 to 32,767) that the user can enter. 0 means unlimited.
NilIsNull	Whether to set the data value of the InkEdit to null when the user leaves the edit box blank. Values are: Yes – Make the Empty string null. No – Do not make the empty string null (default).
RecognitionTimer	Specifies the time period in milliseconds between the last ink stroke and the start of text recognition. The default is 2000 (two seconds).
Required	Whether the column is required. Values are: Yes – Required. No – (Default) Not required.
UseMouseForInput	Specifies whether the mouse can be used for input on a Tablet PC. Values are: true – The mouse can be used for input false – The mouse cannot be used for input (default)
VScrollbar	Whether a vertical scroll bar displays in the edit control. Values are: Yes – Display a vertical scroll bar. No – Do not display a vertical scroll bar (default).

Usage

The following values for Factoid are available. After the Default and None factoids, the drop-down list in the Properties view displays factoids for special formats in alphabetical order, followed by single-character factoids and Asian-language factoids. You can set multiple factoids by separating them with the pipe ( | ) character.

Factoid	Description
Default	Returns recognizer to the default setting. For Western languages, the default setting includes the user and system dictionaries, various punctuation marks, and the Web and Number factoids. For Eastern languages, the default setting includes all characters supported by the recognizer.
None	Disables all factoids, dictionaries, and the language model.
Currency	Currency in pounds, dollars, euros, and yen.
Date	Dates written in English; for example 8/19/2005, Aug 19, 2005, or Friday, August 19, 2005.
E-mail	E-mail addresses.
Filename	Windows file name paths. The name cannot include the following characters: / : " < > \|
Number	Numeric values, including ordinals, decimals, separators, common suffixes, and mathematical symbols. This factoid includes the Currency and Time factoids.
Percent	A number followed by the percent symbol.
Postal Code	Postal codes as written in English, for example 01730 or CT17 9PW.
System Dictionary	Words in the system dictionary only.
Telephone	Telephone numbers as written in English, for example (555) 555 5555 or +44 1234 123456.
Time	Times as written in English, for example 15:05 or 3:05 pm.
Web	Various URL formats.
Word List	Words on the word list associated with the recognizer context only.
Digit	A single digit (0-9).
One Char	A single ANSI character.
Upper Char	A single uppercase character.

In addition, the following Asian-language factoids are available:

Bopomofo	Kanji Common
Hangul Common	Katakana
Hiragana	Korean Common
Jamo	Simplified Chinese Common
Japanese Common	Traditional Chinese Common

In the painter

Select the control and set values in the Properties window, Behavior category. The EditStyle on the Edit category must be set to InkEdit.

In DataWindow .NET, you can use the InkEdit class to set InkEdit Edit style properties using dot notation. See the description of the InkEdit class in the online Help in Visual Studio .NET for a complete list of properties.

Examples

Example 1

[Visual Basic]
str = dw1.Describe("emp_bd.InkEdit.Factoid")

dw1.Modify("emp_bd.InkEdit.Factoid=EMAIL")

Example 2

[Visual Basic]
If TypeOf empBnfts.EditStyle Is InkEdit Then
   CType(empBnfts.EditStyle, InkEdit).LeftText = True
ElseIf
...

[C#]
if (empBnfts.EditStyle is InkEdit)
{
   ((InkEdit)empBnfts.InkEdit).LeftText = true;
}
else
....