SelectionRectangle QML Type

Used to select table cells inside a TableView. More...

• List of all members, including inherited members

Properties

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

Attached Properties

• control : SelectionRectangle
• dragging : bool

Detailed Description

SelectionRectangle is used for selecting table cells in a TableView. It lets the user start a selection by doing a pointer drag inside the viewport, or by doing a long press on top of a cell.

For a SelectionRectangle to be able to select cells, TableView must have an ItemSelectionModel assigned. The ItemSelectionModel will store any selections done on the model, and can be used for querying which cells that the user has selected.

The following example shows how you can make a SelectionRectangle target a TableView:

     TableView {
         id: tableView
         anchors.fill: parent
         clip: true

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

         selectionModel: ItemSelectionModel {
             model: tableView.model
         }

         delegate: Rectangle {
             implicitWidth: 100
             implicitHeight: 30
             color: selected ? "blue" : "lightgray"

             required property bool selected

             Text { text: display }
         }
     }

     SelectionRectangle {
         target: tableView
     }

Note: A SelectionRectangle itself is not shown as part of a selection. Only the delegates (like topLeftHandle and bottomRightHandle) are used. You should also consider rendering the TableView delegate as selected.

See also TableView, TableView::selectionModel, and ItemSelectionModel.

Property Documentation

Attached Property Documentation