WIDTH-PIXELS attribute

The width of the widget or the screen display used in the current session, in pixels.

Data type:

INTEGER

Access:

Readable/Writable

Applies to:

BROWSE widget (browse, column, and cell), BUTTON widget, COMBO-BOX widget, CONTROL-FRAME widget, DIALOG-BOX widget, EDITOR widget, FIELD-GROUP widget, FILL-IN widget, FRAME widget, IMAGE widget, LITERAL widget, RADIO-SET widget, RECTANGLE widget, SELECTION-LIST widget, SESSION system handle, SLIDER widget, TEXT widget, TOGGLE-BOX widget, WINDOW widget

The attribute is read-only for field groups, and the SESSION handle.

In character mode, the WIDTH-PIXELS attribute must be set before the browse is realized. Attempting to set the attribute after realization of the browse causes a run-time error.

For control-frames, the WIDTH-PIXELS attribute maps to the Width property of the control-frame COM object (ActiveX control container).

For editor widgets, this attribute can set the word wrap margin for the WORD-WRAP attribute. For more information, see the WORD-WRAP attribute reference entry.

For browses, the WIDTH-PIXELS attribute sets the width, in pixels, of the browse without changing the width of any browse column. If you change the value of a browse’s WIDTH-CHARS or WIDTH-PIXELS attribute, the horizontal scrollbar might appear or disappear, which might cause the number of rows that appear in the viewport to change.

For browse columns, the WIDTH-PIXELS attribute sets the width, in pixels, of the browse column without changing the width of the browse.