EditMask.property – PB Docs 2022

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.

Values are:

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 DataValue are displayed for specifying code
table entries.

DDCalendar

Whether a drop-down calendar control displays when
a user clicks in a column with a Date or DateTime edit
mask.

Values are:

Yes — Drop-down
calendar control displays.

No — (Default) Drop-down
calendar control does not display.

Painter:
Drop-down Calendar option.

DDCal_AlignRight

Whether the drop-down calendar is aligned with the
right side of the column.

Values
are:

Yes — Column is right aligned.

No
— (Default) Column is left aligned.

Painter: Drop
Align Right option on Other page.

DDCal_BackColor

The background color of the drop-down calendar. The
default is Window Background. This property is not supported on
the Windows 10/11 operating system.

Painter:
CalendarBackColor option on Other page.

DDCal_TextColor

The color of text in the drop-down calendar. The
default is Window Text. This property is not supported on the
Windows 10/11 operating system.

Painter:
CalendarTextColor option on Other page.

DDCal_TitleBackColor

The background color of the title in the drop-down
calendar. The default is Highlight. This property is not
supported on the Windows 10/11 operating
system.

Painter: CalendarTitleBackColor option on
Other page.

DDCal_TitleTextColor

The color of text in the title of the drop-down
calendar. The default is Highlight Text. This property is not
supported on the Windows 10/11 operating
system.

Painter: CalendarTitleTextColor option on
Other page.

DDCal_TrailingTextColor

The color of trailing text (days in the previous
and next months) in the drop-down calendar. The default is
Disabled Text. This property is not supported on the Windows
10/11 operating system.

Painter:
CalendarTrailingTextColor option on Other page.

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.

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.

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. Available for numeric,
date, and time columns.

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.

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 True. Available for numeric, date, and
time columns.

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

Painter:
Spin Range group, Spin Min and Spin Max options.

UseEllipsis

Whether an ellipsis (three dots) displays when a
column with the EditMask edit style contains character data that
is too long for the display column in the
DataWindow.

The ellipsis does not display when the
column has focus.

Values are:

Yes —
Truncate the data and add an ellipsis.

No —
Truncate the data. Do not add an ellipsis.

The
property is ignored if you:

Painter: Use Ellipsis check box on the
Format page.

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.