SelectionRectangle QML Type

Se utiliza para seleccionar celdas de tabla dentro de un TableView. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

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

Propiedades anexas

• control : SelectionRectangle
• dragging : bool

Descripción detallada

SelectionRectangle se utiliza para seleccionar celdas de una tabla en TableView. Permite al usuario iniciar una selección arrastrando el puntero dentro de la ventana gráfica o realizando una pulsación larga sobre una celda.

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 ser utilizado para consultar qué celdas ha seleccionado el usuario.

El siguiente ejemplo muestra cómo puede hacer que un SelectionRectangle tenga como objetivo 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
    }

Véase también TableView, TableView::selectionModel, y ItemSelectionModel.

Documentación de propiedades

active : bool [read-only]

Esta propiedad es true mientras el usuario realiza una selección. La selección estará activa desde el momento en que el usuario comience a seleccionar, y hasta que la selección sea eliminada de nuevo, por ejemplo al pulsar dentro de la ventana gráfica.

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 manejador, el usuario puede arrastrarlo para ajustar la selección.

El manejador no se oculta por defecto cuando se elimina una selección. En su lugar, esto es responsabilidad del delegado, para abrirlo para animaciones personalizadas de desvanecimiento. La forma más fácil de asegurar que el manejador termine oculto, es simplemente enlazar visible al estado active de la propiedad SelectionRectangle:

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

Establezca esta propiedad en null si no desea que aparezca un tirador de selección en la parte inferior derecha.

Véase también topLeftHandle.

dragging : bool [read-only]

Esta propiedad es true siempre que el usuario esté haciendo un arrastre de puntero o un arrastre de asa para ajustar el rectángulo de selección.

selectionMode : enumeration

Esta propiedad indica cuándo debe comenzar una selección.

El valor por defecto es Auto.

target : Item

Esta propiedad contiene el TableView sobre el que debe actuar el 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 manejador, el usuario puede arrastrarlo para ajustar la selección.

El manejador no se oculta por defecto cuando se elimina una selección. En su lugar, esto es responsabilidad del delegado, para abrirlo para animaciones personalizadas de desvanecimiento. La forma más fácil de asegurar que el manejador termine oculto, es simplemente enlazar visible al estado active de la propiedad SelectionRectangle:

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

Establezca esta propiedad en null si no desea que el manejador de selección aparezca en la parte superior izquierda.

Vea también bottomRightHandle.

Documentación de la propiedad Attached

SelectionRectangle.control : SelectionRectangle

Esta propiedad adjunta contiene el SelectionRectangle que gestiona la instancia de delegado. Se adjunta a cada instancia de manejador.

SelectionRectangle.dragging : bool

Esta propiedad adjunta será true si el usuario está arrastrando sobre el asa. Se adjunta a cada instancia de asa.