PdfPageView QML Type

Un componente visor de PDF para mostrar una página cada vez. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• backEnabled : bool
• currentPage : int
• document : PdfDocument
• forwardEnabled : bool
• renderScale : real
• searchModel : PdfSearchModel
• searchString : string
• selectedText : PdfDocument
• sourceSize : size
• status : int
• zoomEnabled : bool

Métodos

• void back()
• void copySelectionToClipboard()
• void forward()
• void goToLocation(int page, point location, real zoom)
• void goToPage(int page)
• void resetScale()
• void scaleToPage(real width, real height)
• void scaleToWidth(real width, real height)
• void searchBack()
• void searchForward()
• void selectAll()

Descripción detallada

PdfPageView proporciona un componente visor de PDF que muestra una página entera a la vez, sin desplazamiento. Permite seleccionar texto y copiarlo en el portapapeles, acercar y alejar la imagen, hacer clic en un enlace interno para saltar a otra sección del documento, girar la vista y buscar texto.

La implementación es un ensamblaje QML de bloques de construcción más pequeños que están disponibles por separado. En caso de que desee realizar cambios en su propia versión de este componente, puede copiar el QML, que se instala en el directorio de módulos QtQuick/Pdf/qml, y modificarlo según sea necesario.

Véase también PdfScrollablePageView, PdfMultiPageView, y PdfStyle.

Documentación de propiedades

backEnabled : bool [read-only]

Esta propiedad indica si es posible retroceder en el historial de navegación a una página vista anteriormente.

Véase también PdfPageNavigator::backAvailable y back().

currentPage : int [read-only]

Esta propiedad contiene el número de página basado en cero de la página visible en la vista desplazable. Si no hay página actual, contiene -1.

Esta propiedad es de sólo lectura y se utiliza normalmente en un enlace (o script onCurrentPageChanged ) para actualizar la parte de la interfaz de usuario que muestra el número de página actual, como SpinBox.

Véase también PdfPageNavigator::currentPage.

document : PdfDocument [required]

Se requiere un objeto PdfDocument con una URL source válida:

import QtQuick
import QtQuick.Pdf

PdfPageView {
    document: PdfDocument { source: "my.pdf" }
}

forwardEnabled : bool [read-only]

Esta propiedad indica si es posible ir a la siguiente ubicación en el historial de navegación.

Véase también PdfPageNavigator::forwardAvailable y forward().

renderScale : real

Esta propiedad contiene la relación entre píxeles y puntos. El valor predeterminado es 1, lo que significa que un punto (1/72 de pulgada) equivale a 1 píxel lógico.

searchModel : PdfSearchModel

Esta propiedad contiene un PdfSearchModel que contiene la lista de resultados de búsqueda para un searchString dado.

Véase también PdfSearchModel.

searchString : string

Esta propiedad contiene la cadena de búsqueda que el usuario puede elegir. Se utiliza normalmente en un enlace a la propiedad text de un TextField.

Véase también searchModel.

selectedText : PdfDocument

El texto seleccionado.

sourceSize : size

Esta propiedad contiene el ancho y alto escalados de la imagen a pantalla completa.

Véase también Image.sourceSize.

status : int

Esta propiedad contiene el rendering status del current page.

zoomEnabled : bool

Esta propiedad indica si el usuario puede utilizar el gesto de pellizcar o Control + rueda del ratón para hacer zoom. Por defecto es true.

Cuando el usuario hace zoom en la página, el tamaño de PdfPageView cambia.

Documentación del método

void back()

Desplaza la vista hacia atrás a la página anterior que el usuario visitó más recientemente; o no hace nada si no hay una ubicación anterior en la pila de navegación.

Véase también PdfPageNavigator::back(), currentPage, y backEnabled.

void copySelectionToClipboard()

Copia el texto seleccionado (si existe) en system clipboard.

Véase también selectAll().

void forward()

Desplaza la vista a la página que el usuario estaba viendo cuando se llamó al método back(); o no hace nada si no hay una ubicación "siguiente" en la pila de navegación.

Véase también PdfPageNavigator::forward() y currentPage.

void goToLocation(int page, point location, real zoom)

Desplaza la vista hasta el location en el page, si es posible, y establece el nivel zoom.

Véase también PdfPageNavigator::jump() y currentPage.

void goToPage(int page)

Cambia la vista a page, si es posible.

Véase también PdfPageNavigator::jump() y currentPage.

void resetScale()

Devuelve a renderScale su valor por defecto de 1.

void scaleToPage(real width, real height)

Establece renderScale de forma que toda la primera página quepa en una ventana gráfica con los valores width y height. El resultado de renderScale depende de la rotación de la página: la página cabrá en la ventana gráfica con un tamaño mayor si primero se rota para que tenga una relación de aspecto adecuada.

void scaleToWidth(real width, real height)

Establece renderScale de forma que la anchura de la primera página quepa en una ventana gráfica con los valores width y height. Si la página no está girada, se escalará de forma que su anchura quepa en width. Si se gira +/- 90 grados, se escalará para que su anchura se ajuste a height.

void searchBack()

Disminuye la searchModel's current result para que la vista salte al resultado de búsqueda anterior.

void searchForward()

Incrementa la searchModel's current result para que la vista salte al siguiente resultado de búsqueda.

void selectAll()

Selecciona todo el texto en current page, y lo hace disponible como el sistema selection en sistemas que soportan esa característica.

Véase también copySelectionToClipboard().