Label Widget Properties

IDL Reference Guide: IDL GUIBuilder Widget Reference

Label Widget Properties

Label widgets display static text. They are similar to single-line text widgets, but they are optimized for small labeling purposes.

There are no label widget-specific event properties.

When programming in IDL, you create label using the WIDGET_LABEL function. For more information, see WIDGET_LABEL.

Note
Use label widgets to display single-line labels that you do not want the user to be able to edit. Use text widgets for displaying larger amounts of text, or text that you want the user to be able to edit.

Label Widget Attributes

For label widgets, you can set common attributes and label-specific attributes. For a list of common attributes, see Common Attributes. These are the label widget attributes:


Alignment	Text
Sunken

Alignment

The Alignment attribute specifies how label Text is aligned. These are the possible values:

Left: The text is left-justified. This is the default value.

Center: The text is centered.

Right: The text is right-justified.

In the generated *.pro file, this value is specified with the ALIGN_CENTER, the ALIGN_RIGHT, or the ALIGN_LEFT keyword to the widget creation routine.

Sunken

The Sunken attribute specifies whether the label should be displayed with a "sunken" border. Sunken borders are often used for status lines and other interface elements in which the text of the label changes based on user actions or the state of the application.

Text

The Text attribute specifies the text string that is displayed in the label widget. By default, this value is set to Label, and you can set it to any string.

In the generated *.pro file, this value is specified with the VALUE keyword to the widget creation routine.

Label Widget Events

There are no events specific to Label widgets. For a list of the common widget events, see Common Events.

IDL Online Help (March 06, 2007)