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 내에서 단 하나의 항목만 사용되는 경우, 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

이 속성은 제목을 포함합니다.

이 속성은 일반적으로 그룹박스 위에 표시되어 그 내용을 요약해 줍니다.