EditMask.property

columnname

The column with the EditMask edit style for which you want to get or set property values. You can specify the column name or a pound sign (#) and the column number.

property

A property for the column’s EditMask style. Properties and their settings are listed in the table below.

value

The value to be assigned to the property. For EditMask properties, you cannot specify a DataWindow expression.

AutoSkip

Whether the EditMask will automatically skip to the next field when the maximum number of characters has been entered:

• Yes — Skip automatically.

• No — Do not skip automatically.

Painter: AutoSkip option.

CodeTable

Whether the column has a code table. Values are:

• Yes — Code table defined.

• No — No code table defined.

Painter: Code Table option. When selected, Display Value and Data Value are displayed for specifying code table entries.

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.

Painter: Show Focus Rectangle option.

InputEditMode

When an editable column has focus, the SIP type on a Pocket PC or the input method edit mode on a Smartphone device. Values are:

• 0 — (Default) Does not change the current SIP type on a Pocket PC or the current edit mode on a Smartphone

• 1 — Numeric mode for a Smartphone

• 2 — T9 mode for a Smartphone

• 3 — Multipress lowercase mode for a Smartphone

• 4 — T9 uppercase mode for a Smartphone

• 5 — T9 first letter uppercase for a Smartphone

• 6 — Multipress uppercase mode for a Smartphone

• 7 — Multipress first letter uppercase for a Smartphone

• 11 — SIP Keyboard mode for a Pocket PC

• 12 — SIP Jot mode for a Pocket PC

• 13 — SIP Block mode for a Pocket PC

• 14 — SIP WordLogic mode for a Pocket PC

• 15 — SIP Transcriber mode for a Pocket PC (Using the Transcriber mode for a DataWindow text field leads to unpredictable results.)

• 16 — Fitaly SIP keyboard for a Pocket PC

Mask

A string containing the edit mask for the column.

Painter: Mask option.

ReadOnly

Whether the column is read-only. This property is valid only if EditMask.Spin is set to Yes. Values are:

• Yes — Do not allow the user to enter data; make the column read-only.

• No — (Default) Allow the user to enter data.

Painter: Read Only option.

Required

Whether the column is required. Values are:

• Yes — It is required.

• No — It is not required.

Painter: Required option.

SipOnFocus

Whether to display or minimize the SIP when the column receives focus. Values are:

• Yes — SIP opens automatically.

• No — SIP closes automatically.

Painter: Show SIP on Focus option.

Spin

Whether the user can scroll through a list of possible values for the column with a spin control. Values are:

• Yes — Display a spin control.

• No — (Default) Do not display a spin control.

Painter: Spin Control option.

SpinIncr

An integer indicating the amount to increment the spin control’s values. The default for numeric values is 1; for dates, 1 year; and for time, 1 minute.

For columns that are not numeric, date, or time, the spin control scrolls through values in an associated code table. If the EditMask.CodeTable property is No, the spin increment has no effect for these columns.

Painter: Spin Increment option (available for numeric, date, and time columns).

SpinRange

A string containing the maximum and minimum values for the column that will display in the spin control. The two values are separated by a tilde (~). This property is effective only if EditMaskSpin is Yes.

Because the SpinRange string is within another quoted string, the tilde separator becomes four tildes in PocketBuilder, which reduces to a single tilde when parsed. The format for the string is:

"EditMask.SpinRange = ' minval~~~~maxval ' "

Painter: Spin Range group, Spin Min and Spin Max options (available for numeric, date, and time columns).

UseFormat

Whether a Format Display mask is used for a column’s display. A Format Display mask is used only when the column does not have focus. Values are:

• Yes — Use a Format Display mask.

• No — (Default) Do not use a Format Display mask.

Painter: Use Format option.