En esta página

PdfMultiPageView QML Type

Un completo componente visor de PDF para desplazarse por varias páginas. Más...

Import Statement: import QtQuick.Pdf
Inherits:

Item

Propiedades

Métodos

Descripción detallada

PdfMultiPageView proporciona un componente visor de PDF que ofrece una experiencia de usuario similar a muchas aplicaciones visor de PDF comunes. Permite hojear las páginas del documento completo, con espacios estrechos entre las imágenes de las páginas.

PdfMultiPageView también 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. El ejemplo de visor multipágina de PDF muestra cómo utilizar estas funciones en una aplicación.

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 PdfPageView, PdfScrollablePageView, 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.

currentPageRenderingStatus : int

Esta propiedad contiene el rendering status del current page.

document : PdfDocument [required]

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

import QtQuick
import QtQuick.Pdf

PdfMultiPageView {
    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().

pageRotation : real

Esta propiedad mantiene la rotación de las páginas en el sentido de las agujas del reloj.

El valor predeterminado es 0 grados (es decir, sin rotación con respecto a la orientación de las páginas almacenadas en el archivo PDF).

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.

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 existe 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)

Desplaza la vista hasta el número page dado, 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 renderScale depende de pageRotation: la página cabrá en la ventana gráfica con un tamaño mayor si primero se gira 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().

© 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.