Pane QML Type

Fournit un arrière-plan correspondant au style et au thème de l'application. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

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

Description détaillée

Le volet fournit une couleur d'arrière-plan qui correspond au style et au thème de l'application. Le volet ne fournit pas de mise en page propre, mais vous devez positionner son contenu, par exemple en créant un RowLayout ou un ColumnLayout.

Les éléments déclarés comme enfants d'un volet sont automatiquement rattachés au volet contentItem. Les éléments créés dynamiquement doivent être explicitement rattachés au volet contentItem.

Comme indiqué à l'adresse Event Handling, le volet ne laisse pas les événements de clic et de toucher se répercuter sur les éléments qui se trouvent en dessous de lui. Si wheelEnabled est true, il en va de même pour les événements liés à la roulette de la souris.

Dimensionnement du contenu

Si un seul élément est utilisé dans un volet, il sera redimensionné pour s'adapter à la taille implicite de l'élément qu'il contient. Cela le rend particulièrement adapté à une utilisation avec des mises en page.

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

Il peut arriver que le volet contienne deux éléments :

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

Dans ce cas, le volet ne peut pas calculer une taille implicite raisonnable. Puisque nous ancrons le PageIndicator sur le SwipeView, nous pouvons simplement définir la taille du contenu à la taille implicite de la vue :

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

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

Si contentItem n'a pas de taille implicite et n'a qu'un seul enfant, Pane utilisera la taille implicite de cet enfant. Par exemple, dans le code suivant, le volet prend la taille du rectangle :

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

Voir également Personnalisation du volet, Contrôles de conteneur, Gestion du focus dans les contrôles Qt Quick , et Event Handling.

Documentation sur les propriétés

contentChildren : list<Item>

Cette propriété contient la liste des enfants du contenu.

La liste contient tous les éléments qui ont été déclarés en QML comme enfants du volet.

Voir également Item::children et contentData.

contentData : list<QtObject> [default]

Cette propriété contient la liste des données de contenu.

La liste contient tous les objets qui ont été déclarés en QML comme enfants du volet.

Voir également Item::data et contentChildren.

contentHeight : real

Cette propriété contient la hauteur du contenu. Elle est utilisée pour calculer la hauteur totale implicite du volet.

Pour plus d'informations, voir Content Sizing.

Voir également contentWidth.

contentWidth : real

Cette propriété contient la largeur du contenu. Elle est utilisée pour calculer la largeur totale implicite du volet.

Pour plus d'informations, voir Content Sizing.

Voir également contentHeight.