Progress
Language Reference


WIDTH-CHARS Attribute

The width of the widget or the display used in the current session, in character units.

Data Type: DECIMAL

Access: Readable/Writable

Applies To: Browse, Browse-column, Buffer-field Object Handle, Button, Combo-box, Control-frame, Dialog-box, Editor, Field-group, Fill-in, Frame, Image, Literal, Radio-set, Rectangle, Selection-list, SESSION System Handle, Slider, Text, Toggle-box, Window

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

For control-frames, the WIDTH-CHARS 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 buffer-field objects, the WIDTH-CHARS attribute is the number of characters in the STRING-VALUE, which Progress calculates using the FORMAT attribute. In addition, the WIDTH-CHARS attribute of a buffer-field is readable but not writeable.

For browses, the WIDTH-CHARS attribute sets the width, in characters, 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-CHARS attribute sets the width, in characters, of the browse-column without changing the width of the browse.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095