Pane QML Type

애플리케이션의 스타일과 테마에 어울리는 배경을 제공합니다. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• contentChildren : list<Item>
• contentData : list<QtObject>
• contentHeight : real
• contentWidth : real

상세 설명

Pane은 애플리케이션 스타일 및 테마와 어울리는 배경색을 제공합니다. Pane은 자체 레이아웃을 제공하지 않으며, 사용자가 RowLayout 이나 ColumnLayout 을 생성하는 등의 방법으로 내용을 배치해야 합니다.

Pane의 자식으로 선언된 항목은 자동으로 Pane의 contentItem 에 종속됩니다. 동적으로 생성된 항목은 contentItem 에 명시적으로 종속시켜야 합니다.

Event Handling 에서 언급된 바와 같이, Pane은 클릭 및 터치 이벤트를 그 아래의 항목으로 전달하지 않습니다. wheelEnabled 가 true 인 경우, 마우스 휠 이벤트에도 동일한 규칙이 적용됩니다.

콘텐츠 크기 조정

Pane 내에서 단 하나의 항목만 사용되는 경우, Pane은 포함된 항목의 암시적 크기에 맞춰 크기가 조정됩니다. 이로 인해 레이아웃과 함께 사용하기에 특히 적합합니다.

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

때로는 Pane 내에 두 개의 항목이 포함될 수도 있습니다:

Pane {
    SwipeView {
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
}

이 경우, Pane은 적절한 암시적 크기를 계산할 수 없습니다. PageIndicator 을 SwipeView 위에 고정하고 있으므로, 콘텐츠 크기를 뷰의 암시적 크기로 간단히 설정할 수 있습니다:

Pane {
    contentWidth: view.implicitWidth
    contentHeight: view.implicitHeight

    SwipeView {
        id: view
        // ...
    }
    PageIndicator {
        anchors.horizontalCenter: parent.horizontalCenter
        anchors.bottom: parent.bottom
    }
 }

contentItem 에 암시적 크기가 없고 자식 요소가 하나뿐인 경우, Pane은 해당 자식 요소의 암시적 크기를 사용합니다. 예를 들어, 다음 코드에서 Pane은 Rectangle의 크기를 가정합니다:

Pane {
    Item {
        Rectangle {
            implicitWidth: 200
            implicitHeight: 200
            color: "salmon"
        }
    }
}

‘Pane 사용자 지정’, ‘컨테이너 컨트롤’, ‘ Qt Quick Controls 의 포커스 관리’ 및 ‘ Event Handling ’항목도 참조하십시오 .

속성 설명서

contentChildren : list<Item>

이 속성은 콘텐츠 자식 요소들의 목록을 포함합니다.

이 목록에는 QML에서 해당 패널의 자식으로 선언된 모든 항목이 포함됩니다.

Item::children 및 contentData도 참조하십시오 .

contentData : list<QtObject> [default]

이 속성은 콘텐츠 데이터 목록을 포함합니다.

이 목록에는 QML에서 해당 패널의 자식 객체로 선언된 모든 객체가 포함됩니다.

Item::data 및 contentChildren도 참조하십시오 .

contentHeight : real

이 속성은 콘텐츠의 높이를 저장합니다. 이 속성은 패널의 총 암시적 높이를 계산하는 데 사용됩니다.

자세한 내용은 Content Sizing 을 참조하십시오.

contentWidth도 참조하십시오 .

contentWidth : real

이 속성은 콘텐츠의 너비를 저장합니다. 이 속성은 창(pane)의 총 암시적 너비를 계산하는 데 사용됩니다.

자세한 내용은 Content Sizing 을 참조하십시오.

contentHeight도 참조하십시오 .