# Labels & Group Boxes

A label is used to place explanatory text or titles in a dialog box. It can be positioned anywhere within the dialog. A group box can be attached to the label and sized to enclose a set of controls with some common property. Using the “Edit/Properties” option you can set the following attributes:

Label – The text of the label

Show group box – Defines whether a group box will be shown

Width – The width in font units of the group box.

Height – The height in font units of the group box.

SIMSCRIPT Users:

Through the “Properties” dialog, SIMSCRIPT users can define whether the label is defined programmatically through the DTVAL.A or the DDVAL.A attribute of its field pointer. One of the following three access modes can be defined:

a) Use the DTVAL.A attribute to define the text.

b) Use the DTVAL.A attribute to define the text; truncate the text to “Field width” places.

c) Use the DDVAL.A attribute to define a real value displayed by the label. The “Field width” text box specifies the total number of places, while the “Precision” box defines the number of places after the decimal point.

For example, if the label’s reference name is “MY.LABEL”, you programmatically set the label as follows:

    Let DTVAL.A(DFIELD.F(

“

    MY.LABEL

”

    , FORM.PTR)) =

“

    Hello World

”

or

    Let DDVAL.A(DFIELD.F(

“

    MY.LABEL

”

    , FORM.PTR)) = 12.5

See Also

Controls.