TLabel class

In unit StdCtrls

Control used to display static text, possibly in multiple lines and rotated by an arbitrary angle.

Declaration

pascal

TLabel = class(TCustomLabel)

Inheritance

Description

TLabel is a TCustomLabel descendant which implements a control to display static text on a form. The value in the control is not editable visually, and can be used to label or describe another control on the form or a container. Since it cannot be edited, it is not allowed to receive the input focus. It can, however, be used to set focus to an associated control using an accelerator key defined in the Caption for the control.

Use TStaticText to display static text and respond to keyboard input directly in the control.

Properties

`Align`	published	Specifies the placement of the control on its Parent control.
`Alignment`	published	Horizontal text justification in the control (left- or right-justified, or centered).
`Anchors`	published	The set of anchor definitions for this control.
`AutoSize`	published	Enables or disables auto-sizing the control to its content.
`BidiMode`	published	Indicates whether text controls use in bi-directional reading.
`BorderSpacing`	published	Determines the inner and outer border spacing for this control.
`Caption`	published	The text displayed for the control.
`Color`	published	Contains the color used for the background on the control.
`Constraints`	published	Contains the minimum and maximum Width and Height for the control.
`DragCursor`	published	The cursor shape shown during a drag operation.
`DragKind`	published	Indicates the action performed for a drag operation: drag-and-drop or drag-and-dock.
`DragMode`	published	Determines how a drag operation is started for the control.
`Enabled`	published	Determines whether the control responds to mouse or keyboard input.
`FocusControl`	published	The control associated with the label and its accelerator key (AccelChar).
`Font`	published	The font to be used for text display in this control.
`Layout`	published	Vertical alignment for control text (at the top, bottom, or center).
`OptimalFill`	published	If True, the font size is adjusted for optimal fill of the available space.
`ParentBidiMode`	published	Indicates whether the BiDiMode settings in the Parent control are used.
`ParentColor`	published	Use the Color from the Parent control, when enabled.
`ParentFont`	published	Indicates if the Font from the Parent control is used in the control.
`ParentShowHint`	published	If True, the value of ShowHint for the control will be the same as the one from the Parent. Default is True.
`PopupMenu`	published	A context-sensitive menu that pops up when the right mouse button is clicked over this control.
`ShowAccelChar`	published	Underlines the character in the label that acts as the accelerator or short cut key.
`ShowHint`	published	Enables Hint display for the control.
`Transparent`	published	Indicates whether the viewer can see through the control.
`Visible`	published	Allows the control, and all of its children, to be displayed or hidden.
`WordWrap`	published	Allows the caption to wrap to multiple lines when it is wider than a specified length.
`WordWrapLength`	published	Defines the maximum pixel of the label caption at which the text is wrapped to a new line.

Events

`OnChangeBounds`	published	Event handler signalled when the Bounds for the control have been changed.
`OnClick`	published	Notification handler for mouse clicks.
`OnContextPopup`	published	Invoked when a context-sensitive pop-up menu is requested.
`OnDblClick`	published	Event handler signalled when a mouse double click occurs in the control.
`OnDragDrop`	published	Event handler signalled when an object is dropped onto the control.
`OnDragOver`	published	Event handler signalled when a control is dragged over the control instance.
`OnEndDrag`	published	Event handler signalled for the end of a drag-drop operation.
`OnMouseDown`	published	Event handler signalled when a mouse down event is handled for the control.
`OnMouseEnter`	published	Event handler signalled when the mouse pointer has entered the control.
`OnMouseLeave`	published	Event handler signalled when the mouse pointer has left the control.
`OnMouseMove`	published	Event handler signalled when the mouse pointer is moved in the control.
`OnMouseUp`	published	Event handler signalled when a mouse up event is handled for the control.
`OnMouseWheel`	published	Event handler for mouse wheel turned.
`OnMouseWheelDown`	published	Event handler signalled for a downward movement of the mouse wheel.
`OnMouseWheelUp`	published	Event handler signalled for an upward movement of the mouse wheel.
`OnMouseWheelHorz`	published	Event handler signalled for a horizontal movement of the mouse wheel.
`OnMouseWheelLeft`	published	Event handler signalled for a leftward movement of the mouse wheel.
`OnMouseWheelRight`	published	Event handler signalled for a rightward movement of the mouse wheel.
`OnResize`	published	Notification handler for a resize of the control.
`OnStartDrag`	published	Event handler signalled for the start of a dragging operation.