PdfSelection QML Type

Representación de una selección de texto en un documento PDF. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• document : PdfDocument
• from : point
• geometry : list<list<point>>
• hold : bool
• page : int
• renderScale : real
• text : string
• to : point

Métodos

• void clear()
• void copyToClipboard()
• void selectAll()

Descripción detallada

PdfSelection proporciona la cadena de texto y su geometría dentro de un cuadro delimitador de un punto a otro.

Para modificar la selección utilizando el ratón, vincule from y to a las propiedades adecuadas de un manejador de entrada para que se establezcan en las posiciones donde comienza y termina el gesto de arrastre, respectivamente; y vincule la propiedad hold para que se establezca en true durante el gesto de arrastre y en false cuando finalice el gesto.

PdfSelection también maneja directamente las consultas del método de entrada para que se puedan utilizar los manejadores de selección de texto en plataformas como iOS. Para ello, debe tener el foco del teclado.

Documentación de propiedades

document : PdfDocument

Esta propiedad contiene el documento PDF en el que seleccionar el texto.

from : point

La ubicación inicial, en píxeles desde la esquina superior izquierda de la página, desde la que encontrar el texto seleccionado. Puede vincularse a centroid.pressPosition de DragHandler para comenzar a seleccionar texto desde la posición en la que el usuario pulsa el botón del ratón y comienza a arrastrarlo, por ejemplo.

geometry : list<list<point>>

Un conjunto de rutas en una forma que se puede vincular a la propiedad paths de una instancia de PathMultiline para renderizar un lote de rectángulos alrededor de las regiones de texto que se incluyen en la selección:

PdfDocument {
    id: doc
}
PdfSelection {
    id: selection
    document: doc
    from: textSelectionDrag.centroid.pressPosition
    to: textSelectionDrag.centroid.position
    hold: !textSelectionDrag.active
}
Shape {
    ShapePath {
        PathMultiline {
            paths: selection.geometry
        }
    }
}
DragHandler {
    id: textSelectionDrag
    acceptedDevices: PointerDevice.Mouse | PointerDevice.Stylus
    target: null
}

Véase también PathMultiline.

hold : bool

Controla si se mantiene la selección existente independientemente de los cambios en from y to. Esta propiedad se puede establecer en true cuando se suelta el ratón o el punto táctil, para que la selección no se pierda debido a que cambien los puntos de enlace.

page : int

El número de página en el que buscar.

Véase también QtQuick::Image::currentFrame.

renderScale : real

La relación de puntos a píxeles a la que se representa la página.

Se utiliza para escalar from y to para encontrar rangos de caracteres seleccionados en el documento, porque las posiciones dentro del documento siempre se dan en puntos.

text : string

El texto que se encontró en el área rectangular entre from y to, o todo el texto en page si se llamó a selectAll().

to : point

La ubicación final, en píxeles desde la esquina superior izquierda de la página, a partir de la cual encontrar el texto seleccionado. Puede vincularse a centroid.position de DragHandler para finalizar la selección de texto en la posición en la que el usuario está arrastrando el ratón, por ejemplo.

Documentación del método

void clear()

Borra la selección actual.

void copyToClipboard()

Copia el texto sin formato de la propiedad text al portapapeles del sistema.

void selectAll()

Selecciona todo el texto de la página page.