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
....

See also