SelectionRectangle QML Type

Utilisé pour sélectionner les cellules d'un tableau à l'intérieur d'un TableView. Plus...

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

Propriétés

• active : bool
• bottomRightHandle : Component
• dragging : bool
• selectionMode : enumeration
• target : Item
• topLeftHandle : Component

Propriétés rattachées

• control : SelectionRectangle
• dragging : bool

Description détaillée

SelectionRectangle est utilisé pour sélectionner les cellules d'un tableau dans un site TableView. Il permet à l'utilisateur de commencer une sélection en faisant glisser le pointeur à l'intérieur de la fenêtre d'affichage ou en appuyant longuement sur le dessus d'une cellule.

Pour qu'un SelectionRectangle puisse sélectionner des cellules, un ItemSelectionModel doit être attribué à TableView. Le site ItemSelectionModel stocke toutes les sélections effectuées sur le modèle et peut être utilisé pour demander quelles cellules ont été sélectionnées par l'utilisateur.

L'exemple suivant montre comment faire en sorte qu'un SelectionRectangle cible un TableView:

    TableView {
        id: tableView
        anchors.fill: parent
        clip: true
        acceptedButtons: Qt.NoButton // mouse-drag changes selection

        model: TableModel {
            TableModelColumn { display: "name" }
            TableModelColumn { display: "age" }
            rows: [ { "name": "Harry", "age": "11" },
                    { "name": "Hedwig", "age": "8" } ]
        }

        selectionModel: ItemSelectionModel {
            model: tableView.model
        }

        delegate: TableViewDelegate { padding: 2 }
    }

    SelectionRectangle {
        target: tableView
    }

Voir également TableView, TableView::selectionModel, et ItemSelectionModel.

Documentation sur les propriétés

active : bool [read-only]

Cette propriété est true lorsque l'utilisateur effectue une sélection. La sélection est active à partir du moment où l'utilisateur commence à sélectionner et jusqu'à ce que la sélection soit à nouveau supprimée, par exemple en tapant à l'intérieur de la fenêtre de visualisation.

bottomRightHandle : Component

Cette propriété contient le délégué qui sera affiché au centre du coin supérieur gauche du rectangle de sélection. Lorsqu'une poignée est fournie, l'utilisateur peut la faire glisser pour ajuster la sélection.

La poignée n'est pas masquée par défaut lorsqu'une sélection est supprimée. C'est au délégué qu'il incombe de l'ouvrir pour les animations de fondu enchaîné personnalisées. La façon la plus simple de s'assurer que la poignée est cachée est de lier visible à l'état active de SelectionRectangle:

SelectionRectangle {
    bottomRightHandle: Rectangle {
        width: 20
        height: 20
        visible: SelectionRectangle.control.active
    }
}

Définissez cette propriété à null si vous ne voulez pas de poignée de sélection en bas à droite.

Voir aussi topLeftHandle.

dragging : bool [read-only]

Cette propriété est true lorsque l'utilisateur fait glisser le pointeur ou la poignée pour ajuster le rectangle de sélection.

selectionMode : enumeration

Cette propriété détermine le moment où la sélection doit commencer.

La valeur par défaut est Auto.

target : Item

Cette propriété contient le site TableView sur lequel le site SelectionRectangle doit agir.

topLeftHandle : Component

Cette propriété contient le délégué qui sera affiché au centre du coin supérieur gauche du rectangle de sélection. Lorsqu'une poignée est fournie, l'utilisateur peut la faire glisser pour ajuster la sélection.

La poignée n'est pas masquée par défaut lorsqu'une sélection est supprimée. C'est au délégué qu'il incombe de l'ouvrir pour les animations de fondu enchaîné personnalisées. La façon la plus simple de s'assurer que la poignée est cachée est de lier visible à l'état active de SelectionRectangle:

SelectionRectangle {
    topLeftHandle: Rectangle {
        width: 20
        height: 20
        visible: SelectionRectangle.control.active
    }
}

Définissez cette propriété à null si vous ne voulez pas de poignée de sélection en haut à gauche.

Voir aussi bottomRightHandle.

Documentation sur les propriétés attachées

SelectionRectangle.control : SelectionRectangle

Cette propriété attachée contient le site SelectionRectangle qui gère l'instance de délégué. Elle est attachée à chaque instance de handle.

SelectionRectangle.dragging : bool

Cette propriété attachée sera true si l'utilisateur fait glisser la poignée. Elle est attachée à chaque instance de poignée.