Progress
AppBuilder
Developer’s Guide
Configuring Rectangle Properties
Rectangles are basic objects, defined in the 4GL itself. Not being objects defined by external procedures, they do not have Procedure Settings. Their properties are all contained in property sheets.
To open the property sheet for a Rectangle, select the Rectangle and choose Tools
property sheet. The dialog box shown in Figure 3–7 will open.
Figure 3–7: Rectangle Property Sheet
![]()
Minimal Configuration Changes
You should change the default identifier, shown in the Object field, to a token that more accurately identifies the role of this Rectangle in your design.
Border Width (Edge Pixels)
Rectangles can be very useful as a way to visually define a special area, for example one whose appearance will change because of paging. You might wish to make such an area even more visually special by changing the thickness of the border. This Rectangle shows a distinctive, eight-pixel border:
![]()
To change the thickness of the border, enter the new value in the Edge Pixels field. The results of specifying too thick a border are undefined.
A value of zero (0) will cause the Rectangle border to disappear, effectively making the Rectangle itself disappear unless it has a fill of a contrasting color.
Geometry
Normally, the location of a widget is calculated at its upper-left corner. You can set the location of a Rectangle to be its upper-right corner instead, if you wish, by setting the appropriate radio button.
Additionally, by setting the width or height of a Rectangle to zero (0) pixels in the Advanced Properties dialog box, you can create the illusion of a line.
Miscellaneous Properties (Other Settings)
Rectangles are such simple objects that they have very few properties. You can make changes to those few, if the default settings do not meet your needs:
- Enable — Normally set. Clearing this box causes the Rectangle to decline input focus when offered. For this option to be meaningful, you must also set either the Movable or Resizable property. For more information, see the “Advanced Properties” section.
- Filled — Normally cleared. Setting this box fills the Rectangle with the background color.
- Graphic Edge — Normally set. This box interacts with the Edge Pixels (border thickness) setting:
- Specifying an Edge Pixels value of three or less causes a line-drawing character to be used for the border in character environments. Values over three clears this box and a block character is used for the border in character environments.
- Clearing this box sets the Edge Pixels value to eight and a block character is used for the border in character environments.
- Hidden — Normally cleared. Setting this box prevents the Rectangle from displaying itself in response to implicit requests. See the online help for further information.
Advanced Properties
You can make several changes to a Rectangle’s behavior or appearance in the Advanced Properties dialog. To open the dialog box, shown in Figure 3–8, choose the Advanced button.
Figure 3–8: Rectangle Advanced Properties Dialog Box
![]()
Four properties you may wish to modify are:
- Manual Highlight — Normally cleared. Setting this box allows you to define and use a special highlighting scheme when the object is selected.
- Movable — Normally cleared. Setting this box plus the Selectable and Enabled boxes allows the user to move the Rectangle within the bounds of the enclosing Frame object.
- Resizable — Normally cleared. Setting this box plus the Selectable and Enabled boxes allows the user to resize the Rectangle within the bounds of the enclosing Frame object.
- Selectable — Normally cleared. Setting this box plus the Enabled box allows the user to select the Rectangle.
Copyright © 2004 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095 |