Pane QML Type

Stellt einen Hintergrund bereit, der zum Stil und zum Thema der Anwendung passt. Mehr...

• Liste aller Elemente, einschließlich der vererbten Elemente

Eigenschaften

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

Ausführliche Beschreibung

„Pane“ stellt eine Hintergrundfarbe bereit, die zum Stil und zum Design der Anwendung passt. „Pane“ verfügt über kein eigenes Layout, sondern erfordert, dass Sie seinen Inhalt positionieren, beispielsweise durch das Erstellen eines „ RowLayout “ oder eines „ ColumnLayout “.

Elemente, die als untergeordnete Elemente eines „Pane“ deklariert werden, werden automatisch dem „ contentItem “ des „Pane“ zugeordnet. Dynamisch erstellte Elemente müssen explizit dem „ contentItem “ zugeordnet werden.

Wie unter „ Event Handling “ erwähnt, lässt „Pane“ keine Klick- und Touch-Ereignisse an darunterliegende Elemente weiter. Wenn „ wheelEnabled “ auf „ true “ gesetzt ist, gilt dies auch für Mausrad-Ereignisse.

Größenanpassung des Inhalts

Wird innerhalb eines Pane nur ein einziges Element verwendet, passt sich dessen Größe automatisch an die implizite Größe des darin enthaltenen Elements an. Dadurch eignet es sich besonders gut für die Verwendung in Verbindung mit Layouts.

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

Manchmal können sich zwei Elemente innerhalb des Pane befinden:

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

In diesem Fall kann „Pane“ keine sinnvolle implizite Größe berechnen. Da wir das „ PageIndicator “ über dem „ SwipeView “ verankern, können wir die Inhaltsgröße einfach auf die implizite Größe der Ansicht setzen:

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

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

Wenn das „ contentItem “ keine implizite Größe hat und nur ein untergeordnetes Element enthält, verwendet „Pane“ die implizite Größe dieses untergeordneten Elements. Im folgenden Code nimmt „Pane“ beispielsweise die Größe des „Rectangle“ an:

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

Siehe auch „Anpassen von Pane“, „Container-Steuerelemente“, „Fokusverwaltung in Qt Quick Controls “ und „ Event Handling “.

Dokumentation zu den Eigenschaften

contentChildren : list<Item>

Diese Eigenschaft enthält die Liste der untergeordneten Elemente.

Die Liste enthält alle Elemente, die in QML als untergeordnete Elemente des Fensters deklariert wurden.

Siehe auch „ Item::children “ und „ contentData “.

contentData : list<QtObject> [default]

Diese Eigenschaft enthält die Liste der Inhaltsdaten.

Die Liste enthält alle Objekte, die in QML als untergeordnete Elemente des Fensters deklariert wurden.

Siehe auch „ Item::data “ und „ contentChildren “.

contentHeight : real

Diese Eigenschaft gibt die Höhe des Inhalts an. Sie wird zur Berechnung der impliziten Gesamthöhe des Fensters verwendet.

Weitere Informationen finden Sie unter Content Sizing.

Siehe auch contentWidth.

contentWidth : real

Diese Eigenschaft enthält die Breite des Inhalts. Sie wird zur Berechnung der impliziten Gesamtbreite des Fensters verwendet.

Weitere Informationen finden Sie unter Content Sizing.

Siehe auch contentHeight.