ButtonGroup QML Type

Mutually-exclusive group of checkable buttons. 更多...

import 语句：	import QtQuick.Controls 2.2
Since:	Qt 5.7
继承：	QtObject

所有成员列表，包括继承成员

特性

buttons : list<AbstractButton>
checkedButton : AbstractButton

附加特性

group : ButtonGroup

信号

void clicked (AbstractButton button )

方法

void addButton (AbstractButton button )
void removeButton (AbstractButton button )

详细描述

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 或 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 附加特性。

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() 方法。

另请参阅 RadioButton and 按钮控件 .

特性文档编制

[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")
    }
}

另请参阅 group .

checkedButton : AbstractButton

This property holds the currently selected button, or null 若没有。

By default, it is the first checked button added to the button group.

附加特性文档编制

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
}

另请参阅 buttons .

信号文档编制

void clicked ( AbstractButton button )

This signal is emitted when a button in the group has been clicked.

This signal is convenient for implementing a common signal handler for all buttons in the same group.

ButtonGroup {
    buttons: column.children
    onClicked: console.log("clicked:", button.text)
}
Column {
    id: column
    Button { text: "First" }
    Button { text: "Second" }
    Button { text: "Third" }
}

This QML signal was introduced in QtQuick.Controls 2.1 (Qt 5.8).

另请参阅 AbstractButton::clicked() .

方法文档编制

void addButton ( AbstractButton button )

添加 button to the button group.

注意： Manually adding objects to a button group is typically unnecessary. The buttons 特性和 group attached property provide a convenient and declarative syntax.

另请参阅 buttons and group .

void removeButton ( AbstractButton button )

Removes a button 从按钮组。

注意： Manually removing objects from a button group is typically unnecessary. The buttons 特性和 group attached property provide a convenient and declarative syntax.

另请参阅 buttons and group .