Pane QML Type

Permet de choisir un arrière-plan en harmonie avec le style et le thème de l'application. En savoir plus...

• 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 Pane fournit une couleur d'arrière-plan qui s'harmonise avec le style et le thème de l'application. Le Pane ne propose pas de mise en page propre, mais vous demande de positionner son contenu, par exemple en créant un RowLayout ou un ColumnLayout.

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

Comme indiqué dans Event Handling, Pane ne transmet pas les événements de clic et de toucher aux éléments situés en dessous. Si wheelEnabled est défini sur true, il en va de même pour les événements de molette de souris.

Redimensionnement du contenu

Si un seul élément est utilisé dans un Pane, celui-ci s’adaptera à 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 parfois y avoir deux éléments dans le Pane :

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

Dans ce cas, Pane ne peut pas calculer de taille implicite pertinente. Comme nous ancrons l'PageIndicator sur l'SwipeView, nous pouvons simplement définir la taille du contenu sur 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 l’ contentItem n’a pas de taille implicite et ne contient qu’un seul enfant, le Pane utilisera la taille implicite de cet enfant. Par exemple, dans le code suivant, le Pane prend la taille du Rectangle :

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

Voir également Personnalisation de Pane, Contrôles conteneurs, Gestion du focus dans Qt Quick Controls et Event Handling.

Documentation sur les propriétés

contentChildren : list<Item>

Cette propriété contient la liste des éléments enfants de contenu.

Cette 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.

Cette liste contient tous les objets qui ont été déclarés en QML en tant qu'enfants du volet.

Voir également « Item::data » et « contentChildren ».

contentHeight : real

Cette propriété contient la hauteur du contenu. Elle sert à calculer la hauteur implicite totale du volet.

Pour plus d'informations, consultez Content Sizing.

Voir également contentWidth.

contentWidth : real

Cette propriété contient la largeur du contenu. Elle sert à calculer la largeur implicite totale du volet.

Pour plus d'informations, consultez Content Sizing.

Voir également contentHeight.