PdfPageNavigator QML Type

Historial de los destinos visitados dentro de un documento PDF. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• backAvailable : bool
• currentLocation : point
• currentPage : int
• currentZoom : real
• forwardAvailable : bool

Señales

• jumped(int page, point location, qreal zoom)

Métodos

• void back()
• void forward()
• void jump(int page, point location, qreal zoom, bool emitJumped)
• void update(int page, point location, qreal zoom)

Descripción detallada

PdfPageNavigator recuerda los destinos que el usuario ha visitado en un documento PDF y ofrece la posibilidad de avanzar y retroceder.

Documentación de propiedades

backAvailable : bool [read-only]

Se mantiene true si hay un destino de vuelta disponible en el historial.

currentLocation : point

Esta propiedad contiene la ubicación actual en la página que se está visualizando.

currentPage : int

Esta propiedad contiene la página actual que se está visualizando. Si no hay página actual, contiene -1.

currentZoom : real

Esta propiedad contiene la escala de ampliación de la página que se está visualizando.

forwardAvailable : bool [read-only]

Indica true si hay un destino de reenvío disponible en el historial.

Documentación de señales

jumped(int page, point location, qreal zoom)

Esta señal se emite cuando se produce un salto brusco, al índice page especificado, a location en la página y al nivel zoom; pero no cuando simplemente se desplaza por el documento página a página. Es decir, forward(), back() y jump() siempre emiten esta señal; update() no.

Documentación del método

void back()

Despliega la pila, actualiza las propiedades currentPage, currentLocation y currentZoom al destino visto más recientemente y, a continuación, emite la señal jumped().

void forward()

Vuelve a la página, localización y nivel de zoom que se estaba viendo antes de llamar a back(), y entonces emite la señal jumped().

Si se empujó un nuevo destino desde la última vez que se llamó a back(), la función forward() no hace nada, porque hay una bifurcación en la línea de tiempo que hace que se pierda el "futuro".

void jump(int page, point location, qreal zoom, bool emitJumped)

Añade el destino dado, formado por page, location, y zoom, al historial de ubicaciones visitadas. Si emitJumped es false, no se emitirá la señal jumped() .

Si forwardAvailable es true, la llamada a esta función representa una bifurcación en la línea de tiempo que hace que se pierda el "futuro" y, por lo tanto, forwardAvailable cambiará a false.

void update(int page, point location, qreal zoom)

Modifica el destino actual, compuesto por page, location y zoom.

Esto puede ser llamado periódicamente mientras el usuario se mueve manualmente por el documento, de modo que después de que back() sea llamado, forward() saltará de nuevo al destino visto más recientemente en lugar del destino que fue especificado por última vez por jump().

Las señales currentZoomChanged, currentPageChanged y currentLocationChanged se emitirán si se modifican las propiedades respectivas. La señal jumped no se emite, porque esta operación representa un movimiento suave y no un salto de navegación.