QPdfView Class
Un widget visor de PDF. Más...
| Header: | #include <QPdfView> |
| Inherits: | QAbstractScrollArea |
Tipos públicos
Propiedades
|
|
Funciones públicas
| QPdfView(QWidget *parent) | |
| virtual | ~QPdfView() |
| int | currentSearchResultIndex() const |
| QPdfDocument * | document() const |
| QMargins | documentMargins() const |
| QPdfView::PageMode | pageMode() const |
| QPdfPageNavigator * | pageNavigator() const |
| int | pageSpacing() const |
| QPdfSearchModel * | searchModel() const |
| void | setDocument(QPdfDocument *document) |
| void | setDocumentMargins(QMargins margins) |
| void | setPageSpacing(int spacing) |
| void | setSearchModel(QPdfSearchModel *searchModel) |
| qreal | zoomFactor() const |
| QPdfView::ZoomMode | zoomMode() const |
Ranuras públicas
| void | setCurrentSearchResultIndex(int currentResult) |
| void | setPageMode(QPdfView::PageMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPdfView::ZoomMode mode) |
Señales
| void | currentSearchResultIndexChanged(int currentResult) |
| void | documentChanged(QPdfDocument *document) |
| void | documentMarginsChanged(QMargins documentMargins) |
| void | pageModeChanged(QPdfView::PageMode pageMode) |
| void | pageSpacingChanged(int pageSpacing) |
| void | searchModelChanged(QPdfSearchModel *searchModel) |
| void | zoomFactorChanged(qreal zoomFactor) |
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
Descripción detallada
QPdfView es un widget visor de PDF que ofrece una experiencia de usuario similar a muchas aplicaciones visoras de PDF comunes, con dos modes. En el modo MultiPage, permite hojear las páginas del documento completo, con espacios estrechos entre las imágenes de las páginas. En el modo SinglePage, muestra una página cada vez.
Documentación del tipo de miembro
enum class QPdfView::PageMode
Este enum describe el comportamiento general del visor de PDF:
| Constante | Valor | Descripción |
|---|---|---|
QPdfView::PageMode::SinglePage | 0 | Mostrar una página cada vez. |
QPdfView::PageMode::MultiPage | 1 | Permite desplazarse por todas las páginas del documento. |
enum class QPdfView::ZoomMode
Este enum describe el comportamiento de ampliación del visor de PDF:
| Constante | Valor | Descripción |
|---|---|---|
QPdfView::ZoomMode::Custom | 0 | Utilizar sólo zoomFactor. |
QPdfView::ZoomMode::FitToWidth | 1 | Elige automáticamente un factor de zoom para que el ancho de la página quepa en la vista. |
QPdfView::ZoomMode::FitInView | 2 | Elige automáticamente un factor de zoom para que toda la página quepa en la vista. |
Documentación de la propiedad
[since 6.6] currentSearchResultIndex : int
Si esta propiedad se establece en un número positivo, y se establece searchModel, QPdfView dibuja un marco alrededor del resultado de la búsqueda proporcionado por QPdfSearchModel en el índice dado. Por ejemplo, si QPdfSearchModel se utiliza como modelo para un QListView, puede mantener esta propiedad actualizada conectando QItemSelectionModel::currentChanged() desde QListView::selectionModel() a una función que a su vez llame a esta función.
Por defecto es -1, para que no se enmarquen los resultados de la búsqueda.
Esta propiedad se introdujo en Qt 6.6.
Funciones de acceso:
| int | currentSearchResultIndex() const |
| void | setCurrentSearchResultIndex(int currentResult) |
Señal de notificador:
| void | currentSearchResultIndexChanged(int currentResult) |
document : QPdfDocument*
Esta propiedad contiene el documento que se desea visualizar.
Funciones de acceso:
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Señal del notificador:
| void | documentChanged(QPdfDocument *document) |
documentMargins : QMargins
Esta propiedad mantiene los márgenes alrededor de la vista de página.
Funciones de acceso:
| QMargins | documentMargins() const |
| void | setDocumentMargins(QMargins margins) |
Señal del notificador:
| void | documentMarginsChanged(QMargins documentMargins) |
pageMode : PageMode
Esta propiedad establece si se muestra una página cada vez, o todas las páginas del documento. Por defecto es SinglePage.
Funciones de acceso:
| QPdfView::PageMode | pageMode() const |
| void | setPageMode(QPdfView::PageMode mode) |
Señal del notificador:
| void | pageModeChanged(QPdfView::PageMode pageMode) |
pageSpacing : int
Esta propiedad mantiene el tamaño del relleno entre páginas en MultiPage mode .
Funciones de acceso:
| int | pageSpacing() const |
| void | setPageSpacing(int spacing) |
Señal del notificador:
| void | pageSpacingChanged(int pageSpacing) |
[since 6.6] searchModel : QPdfSearchModel*
Si se establece esta propiedad, QPdfView dibuja rectángulos de resaltado sobre los resultados de búsqueda proporcionados por QPdfSearchModel::resultsOnPage(). Por defecto es nullptr.
Esta propiedad se introdujo en Qt 6.6.
Funciones de acceso:
| QPdfSearchModel * | searchModel() const |
| void | setSearchModel(QPdfSearchModel *searchModel) |
Señal de notificador:
| void | searchModelChanged(QPdfSearchModel *searchModel) |
zoomFactor : qreal
Esta propiedad contiene la relación entre píxeles y puntos. El valor por defecto es 1, lo que significa que un punto (1/72 de pulgada) equivale a 1 píxel lógico.
Funciones de acceso:
| qreal | zoomFactor() const |
| void | setZoomFactor(qreal factor) |
Señal notificadora:
| void | zoomFactorChanged(qreal zoomFactor) |
zoomMode : ZoomMode
Esta propiedad indica si se debe utilizar un tamaño personalizado para la(s) página(s), o ampliarlas para ajustarlas a la vista. Por defecto es CustomZoom.
Funciones de acceso:
| QPdfView::ZoomMode | zoomMode() const |
| void | setZoomMode(QPdfView::ZoomMode mode) |
Señal del notificador:
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
Documentación de funciones miembro
[explicit] QPdfView::QPdfView(QWidget *parent)
Construye un visor PDF con el widget padre parent.
[virtual noexcept] QPdfView::~QPdfView()
Destruye el visor de PDF.
QPdfPageNavigator *QPdfView::pageNavigator() const
Este accesorio devuelve la pila de navegación que manejará la navegación atrás/adelante.
© 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.
