En esta página

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:

Control

Propiedades

Propiedades adjuntas

Descripción detallada

Rectángulo de selección para seleccionar elementos de la tabla

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.

ConstanteDescripción
SelectionRectangle.DragLa selección comenzará al arrastrar el puntero dentro de la ventana gráfica
SelectionRectangle.PressAndHoldLa selección comenzará al pulsar y mantener pulsado sobre una celda
SelectionRectangle.AutoSelectionRectangle 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.