The TcxRadioGroup component represents a group of radio buttons functioning together. This means that when the user checks a radio button from the group, others become unchecked. The TcxRadioGroup component is similar to the group of TcxCheckBox components. The difference is that the group of check boxes lets the user choose several options at once, whereas the group of radio buttons only lets the user select one of the mutually exclusive options.

To access the collection of radio buttons displayed by the component, use the Properties.Items property. Using methods of the resulting TcxRadioGroupItems collection, you can add, remove and move radio buttons within the group.

The component recognizes items by their captions. Each item must have a unique caption within the component. Otherwise, the component will not be able to distinguish items.

The radio buttons can be arranged into several columns. The number of columns is specified by the Properties.Columns property.

To get or set the index of the currently selected radio button, use the ItemIndex property.

TcxRadioGroup Properties

TcxRadioGroup 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 caption text of the group box.
`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.
`Height`	Specifies the component’s height.
`Hint`	Specifies the text displayed when the cursor stays over the component.
`ItemIndex`	Specifies the index of the currently selected radio button.
`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.
`Properties`	Returns the `TcxRadioGroupProperties` object that holds specific properties of the radio buttons group 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.

TcxRadioGroup Methods

TcxRadioGroup 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.
`OnChange`	Occurs when the radio group’s selected item is changed.
`OnEditValueChanged`	Occurs when the radio group’s selected item is changed.
`OnClick`	Occurs when the component is clicked.
`OnEnter`	Occurs when the component receives input focus.
`OnExit`	Occurs when the component loses input focus.

TcxRadioGroup Object

See Also