ButtonGroup QML Type
An exclusive group of checkable controls. More...
Import Statement: | import Qt.labs.controls 1.0 |
Inherits: |
Properties
Attached Properties
- group : ButtonGroup
Methods
- void addButton(AbstractButton button)
- void removeButton(AbstractButton button)
Detailed Description
ButtonGroup is a non-visual, mutually exclusive group of buttons. It is used with controls such as RadioButton, where only one of the options can be selected at a time.
The most straight-forward way to use ButtonGroup is to assign a list of buttons. For example, the list of children of a positioner or a layout that manages a group of mutually exclusive buttons.
ButtonGroup { buttons: column.children } Column { id: column RadioButton { checked: true text: qsTr("DAB") } RadioButton { text: qsTr("FM") } RadioButton { text: qsTr("AM") } }
Mutually exclusive buttons do not always share the same parent item, or the parent layout may sometimes contain items that should not be included in the button group. Such cases are best handled using the group attached property.
ButtonGroup { id: radioGroup } Column { Label { text: qsTr("Radio:") } RadioButton { checked: true text: qsTr("DAB") ButtonGroup.group: radioGroup } RadioButton { text: qsTr("FM") ButtonGroup.group: radioGroup } RadioButton { text: qsTr("AM") ButtonGroup.group: radioGroup } }
More advanced use cases can be handled using the addButton() and removeButton() methods.
Note: Types in the Qt.labs module are not guaranteed to remain compatible in future versions.
See also RadioButton.
Property Documentation
[default] buttons : list<AbstractButton>
This property holds the list of buttons.
ButtonGroup { buttons: column.children } Column { id: column RadioButton { checked: true text: qsTr("Option A") } RadioButton { text: qsTr("Option B") } }
See also group.
current : AbstractButton
This property holds the currently selected button, or null
if there is none.
By default, it is the first checked button added to the button group.
Attached Property Documentation
ButtonGroup.group : ButtonGroup
This property attaches a button to a button group.
ButtonGroup { id: group } RadioButton { checked: true text: qsTr("Option A") ButtonGroup.group: group } RadioButton { text: qsTr("Option B") ButtonGroup.group: group }
See also buttons.
Method Documentation
void addButton(AbstractButton button)
Adds a button to the button group.
Note: Manually adding objects to a button group is typically unnecessary. The buttons property and the group attached property provide a convenient and declarative syntax.
void removeButton(AbstractButton button)
Removes a button from the button group.
Note: Manually removing objects from a button group is typically unnecessary. The buttons property and the group attached property provide a convenient and declarative syntax.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qml-qt-labs-controls-buttongroup.html