The TcxLabel component represents a text label that supports various visual effects.

The label text is specified by the Caption property. The style that the label text is painted is specified by the Properties.LabelStyle property. The Properties.Glyph property lets you specify the texture used to draw the label text. To apply the 3D shadow effect to the label text, use the Properties.LabelEffect, Properties.Depth, Properties.Orientation and Properties.ShadowedColor properties.

You can associate the label with a specific form control, for example, text box or combo box, using the FocusControl property. The associated control will receive the input focus when the user presses the label’s access key.

TcxLabel Properties

Name	Description
`Align`	Specifies how the component is aligned within its parent.
`Anchors`	Specifies how the component is anchored to its parent.
`AutoSize`	Specifies whether the component is automatically resized to display its entire contents.
`Caption`	Specifies the label text.
`ChildControl`	Returns the child component by index.
`ChildControlByName`	Returns the child component by name.
`ChildControlCount`	Returns the total number of child components for the given component.
`ClientHeight`	Returns the height of the component’s client area.
`ClientWidth`	Returns the width of the component’s client area.
`Constraints`	Specifies the component’s size constraints.
`Cursor`	Specifies the cursor’s image when it is situated over the component.
`Enabled`	Specifies whether the component is enabled.
`FocusControl`	Specifies the form control associated with the label.
`Height`	Specifies the component’s height.
`Hint`	Specifies the text displayed when the cursor stays over the component.
`Left`	Specifies the horizontal coordinate of the component’s left edge.
`Name`	Specifies the component’s name.
`ParentColor`	Specifies whether the component uses the same background color as its parent.
`ParentFont`	Specifies whether the component uses the same font as its parent.
`ParentShowHint`	Specifies whether the component uses the parent’s `ShowHint` property value instead of its own one.
`Properties`	Returns a `TcxLabelProperties` object that contains specific properties of the label component.
`Property`	Obtains or sets the value of the property specified by its index.
`PropertyByName`	Obtains or sets the value of the property with the specified name.
`PropertyCount`	Returns the number of component properties.
`PropertyName`	Returns the property name by index.
`ShowHint`	Specifies whether to display the component’s hint.
`Style`	Specifies the style of the component.
`TabOrder`	Specifies the component’s tab index.
`TabStop`	Specifies whether the component can be selected by the `Tab` key.
`Top`	Specifies the vertical coordinate of the component’s top edge.
`Transparent`	Specifies whether the component’s background is transparent.
`Visible`	Specifies whether the component is visible on screen.
`Width`	Specifies the component’s width.

TcxLabel Methods

TcxLabel Events

Name	Description
`PropertyExists`	Checks to see if the component has the property with the specified name.
`SetFocus`	Moves the input focus to the component.

Name	Description
`OnFocusChanged`	Occurs when the component receives or loses the input focus.
`OnClick`	Occurs when the component is clicked.
`OnDblClick`	Occurs when the component is double-clicked.
`OnEnter`	Occurs when the component receives the input focus.
`OnExit`	Occurs when the component loses the input focus.
`OnMouseEnter`	Occurs when the mouse pointer enters the component.
`OnMouseLeave`	Occurs when the mouse pointer leaves the component.

TcxLabel Object

See Also