SelectionRectangle QML Type
Se utiliza para seleccionar celdas de una tabla dentro de un elemento ` TableView`. Más...
| Import Statement: | import QtQuick.Controls |
| Since: | Qt 6.2 |
| Inherits: |
Propiedades
- active : bool
- bottomRightHandle : Component
- dragging : bool
- selectionMode : enumeration
- target : Item
- topLeftHandle : Component
Propiedades adjuntas
Descripción detallada

SelectionRectangle se utiliza para seleccionar celdas de una tabla en un TableView. Permite al usuario iniciar una selección arrastrando el puntero dentro del área de visualización o manteniendo pulsada una celda durante un tiempo prolongado.
Para que un SelectionRectangle pueda seleccionar celdas, TableView debe tener asignado un ItemSelectionModel. El ItemSelectionModel almacenará cualquier selección realizada en el modelo y puede utilizarse para consultar qué celdas ha seleccionado el usuario.
El siguiente ejemplo muestra cómo se puede hacer que un SelectionRectangle apunte a 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
}Nota: Un SelectionRectangle en sí mismo no se muestra como parte de una selección. Solo se utilizan los delegados (como topLeftHandle y bottomRightHandle). También debes tener en cuenta rendering the TableView delegate as selected.
Véase también TableView, TableView::selectionModel y ItemSelectionModel.
Documentación de propiedades
active : bool [read-only]
Esta propiedad tiene el valor « true » mientras el usuario está realizando una selección. La selección permanecerá activa desde el momento en que el usuario comience a seleccionar hasta que la selección se elimine de nuevo, por ejemplo, al pulsar dentro del área de visualización.
bottomRightHandle : Component
Esta propiedad contiene el delegado que se mostrará en el centro de la esquina superior izquierda del rectángulo de selección. Cuando se proporciona un controlador, el usuario puede arrastrarlo para ajustar la selección.
El controlador no se oculta de forma predeterminada cuando se elimina una selección. En su lugar, es responsabilidad del delegado permitir animaciones personalizadas de desvanecimiento. La forma más sencilla de garantizar que el controlador quede oculto es simplemente vincular visible al estado « active » de SelectionRectangle:
SelectionRectangle {
bottomRightHandle: Rectangle {
width: 20
height: 20
visible: SelectionRectangle.control.active
}
}Establece esta propiedad en « null » si no quieres que aparezca un controlador de selección en la esquina inferior derecha.
Véase también topLeftHandle.
dragging : bool [read-only]
Esta propiedad tiene el valor « true » siempre que el usuario arrastre el puntero o un controlador para ajustar el rectángulo de selección.
selectionMode : enumeration
Esta propiedad indica cuándo debe comenzar una selección.
| Constante | Descripción |
|---|---|
SelectionRectangle.Drag | La selección comenzará al arrastrar el puntero dentro de la ventana gráfica |
SelectionRectangle.PressAndHold | La selección comenzará al pulsar y mantener pulsado sobre una celda |
SelectionRectangle.Auto | SelectionRectangle elegirá qué modo utilizar en función de la propiedad « target » y del dispositivo de entrada que se esté utilizando. Normalmente, esto significa « Drag » cuando se utiliza un ratón, y « PressAndHold » en una pantalla táctil. Sin embargo, « Drag » solo se utilizará si no entra en conflicto con el deslizamiento rápido. Una forma de evitar el conflicto es desactivar el deslizamiento rápido al arrastrar con el ratón configurando « acceptedButtons » en « Qt.NoButton ». En ese caso, el gesto de desplazamiento con la rueda del ratón o el panel táctil seguirá funcionando, el deslizamiento rápido en la pantalla táctil seguirá funcionando y la selección en la pantalla táctil se podrá iniciar manteniendo pulsado. Otra forma es establecer interactive en false, lo que desactiva por completo el «flicking» y el desplazamiento (quizá esto solo deba hacerse de forma temporal, en algún modo de tu interfaz de usuario). Otra forma más es colocar el TableView dentro de un ScrollView (donde, por defecto, el «flicking» está desactivado para los eventos del ratón). |
El valor por defecto es Auto.
target : Item
Esta propiedad contiene el objeto ` TableView ` sobre el que debe actuar el objeto ` SelectionRectangle `.
topLeftHandle : Component
Esta propiedad contiene el delegado que se mostrará en el centro de la esquina superior izquierda del rectángulo de selección. Cuando se proporciona un controlador, el usuario puede arrastrarlo para ajustar la selección.
El controlador no se oculta de forma predeterminada cuando se elimina una selección. En su lugar, es responsabilidad del delegado gestionarlo, para permitir animaciones personalizadas de desvanecimiento. La forma más sencilla de garantizar que el controlador quede oculto es simplemente vincular visible al estado « active » de SelectionRectangle:
SelectionRectangle {
topLeftHandle: Rectangle {
width: 20
height: 20
visible: SelectionRectangle.control.active
}
}Establece esta propiedad en « null » si no quieres que aparezca un controlador de selección en la esquina superior izquierda.
Véase también « bottomRightHandle ».
Documentación de la propiedad adjunta
SelectionRectangle.control : SelectionRectangle [attached]
Esta propiedad adjunta contiene el objeto ` SelectionRectangle ` que gestiona la instancia del delegado. Se adjunta a cada instancia de `handle`.
SelectionRectangle.dragging : bool [attached]
Esta propiedad asociada será « true » si el usuario está arrastrando el controlador. Está asociada a cada instancia de controlador.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.