Non-Property Control Attributes

This topic describes simple property controls found in the Tools Palette and the attribute values that you can edit for these controls.

Label Control

The Label control provides a textual label for another control; it cannot be created before the control with which it is to be associated. Label controls serve as descriptions for Text Field, Text Area, Combo Box, and List controls; these controls do not have built-in captions, labels, or other descriptive text.

Because an access key requires a textual label, the access key property is assigned to the Label control rather than the controls with no built-in caption text. Info Tips may be assigned to both the label and the property control.

Attributes:

Control List

The control with which this label is associated.

Caption

(optional) The text displayed in the control.

Access Key

(optional) A single character to be used in conjunction with the Alt key to bring focus to the field. The character must exist within the caption text; it will appear underlined in the caption when rendered. Additionally, each access key on a tab must be unique.

Info Tip

(optional) Text that will appear in a tip pop-up when the mouse pointer hovers over the control. If no text is entered, no pop-up tip help is displayed.

Back to top

Image Control

The Image control enables you to embed an image, such as a logo, onto the form. The Layout Designer supports .jpg, .png, .bmp, .wbmp, .gif image formats.

Attributes:

Image

Available under normal circumstances; Unavailable if image data is missing or corrupted.

Content Type

The format of the image (jpg, .png, .bmp, .wbmp, or .gif ).

Scale Image

Set option "Yes" to resize the image to the size of the control.

Set option "No" to keep the original image dimensions.

Back to top

Group Control

<controlGroup> represents a control containing a collection of child controls. Control groups can specify hints about layout of child controls within the group (default horizontal and vertical alignment), used when the client rendering is not precise.

The collection of child controls contained within this control group is represented using sub-elements. The coordinate system of child controls is assumed to be relative to the client area of the parent control group.

Attributes:

Horizontal Align

(optional) The default horizontal alignment of child controls within the group (left or right).

Vertical Align

(optional) The default vertical alignment of child controls within the group (top, middle, or bottom.)

Border

(optional) The border style for the control (Solid, Etched, or None). The default is solid.

Caption

Descriptive text for the control. When specified, replaces the control name.

Caption Vertical Alignment The vertical alignment of the caption: "Above" or "Below"
Caption Horizontal Alignment The horizontal alignment of the caption: "Left" or "Right"
Text Align

The alignment of caption text (left or right).

Back to top

Static Text Control

The static text control is unique in that it can be either a property or non-property control. As a property control, it displays the value of a property without allowing the user to make changes. As a non-property control, it can be used to display a line of text on the form.

Attributes:

Caption

Leave blank for property controls. Use a Label control for descriptive text.

Text Align

(optional) Determines the alignment of displayed text (left or right).

Back to top