Progress
Programming
Handbook
Attributes
The following attributes are the main attributes associated with the direct manipulation of widgets. Other attributes are also associated with direct manipulation but apply solely to grids. For more information on these other attributes, see the "Grids" section.
Table 24–1: Direct-manipulation Attributes Attribute Description SELECTABLE Set this attribute to TRUE if you want to allow the user to highlight a widget before moving or resizing it. This attribute applies to frames and to all field-level widgets. MOVABLE Set this attribute to TRUE to allow the user to move a widget. This attribute applies to frames and to all field-level widgets. RESIZABLE Set this attribute to TRUE to allow the user to resize a widget. This attribute applies to frames and to all field-level widgets. BOX–SELECTABLE Set this attribute to TRUE if you want to allow the user to use selection boxes to select and deselect widgets within a frame. (For more information on selection boxes, see the "Box Selecting" section.) This attribute applies only to frames. SELECTED When the user marks a widget with a mouse, Progress sets this attribute to TRUE. You can also explicitly set this attribute within your code. Progress sets this attribute to FALSE when the user unmarks the widget. This attribute applies to frames and to all field-level widgets. MANUAL–HIGHLIGHT Set this attribute to TRUE if you want to use a custom highlight graphic design. When the user selects a widget, Progress highlights the widget by placing a box around that widget by default. By setting this attribute to TRUE, you can override the Progress default and highlighting the widget yourself. NUM–SELECTED–WIDGETS Use this read-only attribute to determine how many frames and dialog boxes are selected in a window, or how many field-level widgets are selected in a frame or dialog box.
By default, all of these attributes are set to FALSE, except for NUM–SELECTED–WIDGETS, which is an integer and read-only. In addition to the attributes listed in Table 24–1, the GET–SELECTED–WIDGET( ) method allows you to access the widget handle of all selected widgets in a window, dialog box, or frame. For more information on this method, see the Progress Language Reference .
The following procedure illustrates how you might use some of these attributes.
If you set any of the writable attributes in Table 24–1 to TRUE, Progress assumes that you want the user to be able to perform direct manipulation on the widget. As a result, Progress interprets user mouse actions differently and gives higher priority to those mouse events that are associated with direct manipulation (see Table 24–2). For example, if you set a button’s SELECTABLE attribute to TRUE, the user cannot choose the button with a mouse. To choose the widget, the user must use the keyboard instead.
Table 24–2: Direct-manipulation Mouse Events SELECTION START–RESIZE DESELECTION END–RESIZE EMPTY–SELECTION START–BOX–SELECTION START–MOVE END–BOX–SELECTION END–MOVE –
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |