GroupBox QML Type

論理的なコントロールグループのビジュアルフレームとタイトル。詳細...

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• implicitLabelHeight : real (since QtQuick.Controls 2.5 (Qt 5.12))
• implicitLabelWidth : real (since QtQuick.Controls 2.5 (Qt 5.12))
• label : Item
• title : string

詳細説明

GroupBox は、titled のビジュアルフレーム内で、コントロールの論理的なグループを一緒にレイアウトするために使用されます。GroupBox はそれ自体のレイアウトを提供しませんが、RowLayout やColumnLayout を作成するなどして、その内容を配置する必要があります。

GroupBox の子 と し て宣言 さ れた項目は自動的に GroupBox のcontentItem の親にな り ます。動的に作成されたアイテムは、明示的に contentItem に親を設定する必要があります。

GroupBox 内で 1 つのアイテムだけが使用される場合、そのアイテムは含まれるアイテムの暗黙のサイズに合わせてリサイズされます。このため、特にレイアウトとの併用に適しています。

GroupBox {
    title: qsTr("Synchronize")
    ColumnLayout {
        anchors.fill: parent
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

チェック可能な GroupBox

GroupBox にはチェックボックスが内蔵されていませんが、CheckBox と組み合わせることで、チェック可能な GroupBox を簡単に作成できます。

チェックボックスのオン・オフが切り替わったときに、グループボックスの子を有効にしたり無効にしたりするのが一般的なパターンですが、チェックボックスの動作はアプリケーション次第です。

GroupBox {
    label: CheckBox {
        id: checkBox
        checked: true
        text: qsTr("Synchronize")
    }

    ColumnLayout {
        anchors.fill: parent
        enabled: checkBox.checked
        CheckBox { text: qsTr("E-mail") }
        CheckBox { text: qsTr("Calendar") }
        CheckBox { text: qsTr("Contacts") }
    }
}

CheckBox 、GroupBoxのカスタマイズ、コンテナコントロールも参照してください 。

プロパティの説明