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は、その中に含まれるアイテムの暗黙的なサイズに合わせてサイズが調整されます。このため、レイアウトとの併用に特に適しています。

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 の子要素を有効または無効にするのは一般的なパターンですが、チェックボックスの動作をどのように設定するかはアプリケーション次第です。

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のカスタマイズ」、および「コンテナコントロール」も参照してください 。

プロパティのドキュメント

implicitLabelHeight : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティには、暗黙的なラベルの高さが格納されます。

その値は `label ? label.implicitHeight : 0` に等しくなります。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

「implicitLabelWidth」も参照してください 。

implicitLabelWidth : real [read-only, since QtQuick.Controls 2.5 (Qt 5.12)]

このプロパティは、暗黙的なラベルの幅を保持します。

値は `label ? label.implicitWidth : 0` に等しくなります。

このプロパティは、QtQuick.Controls 2.5 (Qt 5.12) で導入されました。

「implicitLabelHeight」も参照してください 。

label : Item

このプロパティは、title を可視化するラベル項目を保持します。

「GroupBoxのカスタマイズ」も参照してください 。

title : string

このプロパティにはタイトルが格納されます。

通常、このプロパティはグループボックスの上部に表示され、その内容を要約します。