The TcxGroupBox component represents a group box control. It is a container component, that is, it can contain other components. You can use TcxGroupBox to group components within a form into a labeled group.

The group caption is specified by the Caption property. The Height and Width properties let you determine or set the group box size. The Color property lets you change the background color of the group box.

Note: If you use a Windows theme other than Windows Classic, the Color property is ignored and the group box is transparent.

The TcxGroupBox component raises a number of events that you can process in your scripts.

TcxGroupBox Properties

TcxGroupBox Properties

Name	Description
`Align`	Specifies how the component is aligned within its parent.
`Alignment`	Specifies the alignment of the group box contents.
`Anchors`	Specifies how the component is anchored to its parent.
`BiDiMode`	Specifies the bi-directional mode for the component.
`Caption`	Specifies the panel caption text.
`ChildControl`	Returns the child component specified by its index.
`ChildControlByName`	Returns the child component by its name.
`ChildControlCount`	Returns the child component specified by its index.
`ClientHeight`	Returns the height of the component’s client area.
`ClientWidth`	Returns the width of the component’s client area.
`Color`	Specifies the background color of the component.
`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.
`Font`	Returns a `TFont` object that specifies the font used to display the panel text.
`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.
`ParentBackground`	Specifies whether the component uses its parent’s theme background.
`ParentBiDiMode`	Specifies whether the component uses its parent’s `BiDiMode` property value.
`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.
`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’s 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.

TcxGroupBox Methods

TcxGroupBox Events

You can also use the TcxGroupBox component as a panel. To do that, set the Alignment property to “alCenterCenter”. This will center the group box caption text within the component.

Name	Description
`PropertyExists`	Returns the value that indicates whether the component has the specified property.
`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.

TcxGroupBox Object

See Also