Develop > Tailoring > Form creation > Forms Designer > Creating and editing forms > Label control

Label control

Use this control to add a label. A label is a single line of text you can use to give titles to forms, give labels to objects within the form, or otherwise place text on the form.

To place a label on a form, click Label and then click the form.
Be sure to put the name of the database field or variable that you want to associate with this control into the Input property.

Best practices

  • Use black for label text.
  • Left-align label text and end it with a colon.
  • Do not create colored text "drop shadows." These do not render well in the Web client.
  • Labels on menu forms (for example, menu.gui.home) should have a font increase of 2.
Property Usage
Name

Specify a unique identifier for the object on the screen. (Optional)

This name is used by external applications, such as RAD, to dynamically change the properties of the object.
X Specify the object’s horizontal position based on the left edge of the object.
Y Specify the object’s vertical position based on the top edge of the object.
Width Specify the width of the object in alignment grid units.
Height Specify the height of the object in alignment grid units.
Visible Select this option to make the object visible on the form. Clear the check box to hide the object from view on the form.
Visible Condition Specify an expression to override the Visible property when that expression evaluates to true.
Caption Specify a text caption for the object.
Caption Condition Specify an expression to override the Caption property when that expression evaluates to true.
Input Specify the database field or variable to associate with this control.
Label for

Specify the name of a control that uses this label.

Note If you specify a variable for this label, you need to provide a valid value here. Otherwise, the label cannot be read by JAWS.

Foreground Color Select the text color from the drop-down list.
Foreground Color Condition Specify a formula to evaluate the ForeColor property at run time. The result of this evaluation overrides the value assigned to the property.
Background Color Specify the Background Color. You must select the Opaque property check box for the Back Color to have an effect. The only Background Color available for a Windows client marquee is black.
Background Color Condition Specify an expression to override the BackColor property when that expression evaluates to true.
Background Style Applies to the display of the label in the Web client only. Select Underline to display the label as underlined text. Select Solid Background to display the label background as a solid colored bar.
Font Select a font for the text of your label, table, timer, or marquee caption from the drop-down list.
Bold Select this option to apply bold to the label, default text, frame caption, or marquee caption.
Bold Condition Specify an expression to override the Bold property when that expression evaluates to true.
Italic Select this option to apply italics to your label, default font, or caption.
Italic Condition Specify an expression to override the Italic property when that expression evaluates to true.
Font Increase Specify the amount, in points, to increase or decrease the standard font size.
Font Increase Condition Specify an expression to override the Font Increase property when that expression evaluates to true.
Array Length

Specify the size of the scrolling region used to view array entries. A scroll bar appears beside the fields to allow users to view the array entries.

  • If a field is assigned an Array Length of 5, the form stacks five fields vertically to allow users to view the five array entries.
  • If Array Length is set to -1, the form dynamically creates as many fields as there are entries in the array.
  • If the Input data type is scalar, only a single text box appears.

The default value is 0, which means one vertical line of information appears.

Note The screen object must be associated with an array data structure.
Heading Level

Specify the heading level for this control so that a corresponding HTML heading tag (<h1> to <h6>) is generated.

Note This function is only supported by the Web client.

Justification Specify the justification for the object label as Left, Right, or Center.

Related concepts

Form creation
Forms Designer
Creating and editing forms
Using the drawing canvas
Forms Designer properties view
Setting properties
Enabling HTML in forms
Forms Designer best practices
Building accessible forms

Related tasks

Access Forms Designer
Create a form using the Form Wizard
Update a form

Related references

Link label control
Wrap label control
Forms Designer controls and tools