Labels
Go Up to Text Controls
Labels display text and are usually placed next to other controls.
Use this component: | When you want users to do this: |
---|---|
Display text on a nonwindowed control. | |
Display text on a windowed control. |
You place a label on a form when you need to identify or annotate another component such as an edit box or when you want to include text on a form. The standard label component, TLabel, is a non-windowed control, so it cannot receive focus; when you need a label with a window handle, use TStaticText instead.
Label properties include the following:
- Caption contains the text string for the label.
- Font, Color, and other properties determine the appearance of the label. Each label can use only one typeface, size, and color.
- FocusControl links the label to another control on the form. If Caption includes an accelerator key, the control specified by FocusControl receives focus when the user presses the accelerator key.
- ShowAccelChar determines whether the label can display an underlined accelerator character. If ShowAccelChar is True, any character preceded by an ampersand (&) appears underlined and enables an accelerator key.
- Transparent determines whether items under the label (such as graphics) are visible.
Note: The Color of a TLabel is always the color of the background unless you set TLabel.Transparent to false.
Labels usually display read-only static text that cannot be changed by the application user. The application can change the text while it is executing by assigning a new value to the Caption property. To add a text object to a form that a user can scroll or edit, use TEdit.