Wrap label control

Use this control to add a multi–line label. You can use this label to give a title to the form, give labels to objects within the form, or otherwise place text on the form.

Search for	Example	Results
A single word	`cat`	Topics that contain the word "cat". You will also find its grammatical variations, such as "cats".
A phrase. You can specify that the search results contain a specific phrase.	`"cat food"` (quotation marks)	Topics that contain the literal phrase "cat food" and all its grammatical variations. Without the quotation marks, the query is equivalent to specifying an OR operator, which finds topics with one of the individual words instead of the phrase.

Search for	Operator	Example
Two or more words in the same topic	`AND` `and` `+` (plus symbol) `&` (ampersand)	`cat AND dog` `"cat food"+milk` `"cat food"&"dog food"`
Either word in a topic	`OR` `or` `\|` (pipe)	`cat OR dog` `cat \| dog`
Topics that do not contain a specific word or phrase	`NOT` `not` `!` (exclamation point)	`NOT cat` `! dog`
Topics that contain one string and do not contain another	`^` (caret)	`cat ^ mouse`
A combination of search types	`( )` parentheses	`cat + (dog \| mouse)` `cat \| dog + (! mouse)`

To place a wrapping label on a form, click Wrap 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.

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.
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.

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.

Specify the object’s horizontal position based on the left edge of the object.

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.

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.

Related concepts