QPdfView Class
Un widget de visualisation de PDF. Plus d'informations...
| Header: | #include <QPdfView> |
| Inherits: | QAbstractScrollArea |
Types publics
Propriétés
|
|
Fonctions publiques
| 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 |
Emplacements publics
| void | setCurrentSearchResultIndex(int currentResult) |
| void | setPageMode(QPdfView::PageMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPdfView::ZoomMode mode) |
Signaux
| 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) |
Description détaillée
QPdfView est un widget de visualisation de PDF qui offre une expérience utilisateur similaire à celle de nombreuses applications courantes de visualisation de PDF, avec deux modes. En mode MultiPage, il permet de feuilleter les pages du document entier, avec des espaces étroits entre les images des pages. En mode SinglePage, il affiche une page à la fois.
Type de membre Documentation
enum class QPdfView::PageMode
Cette énumération décrit le comportement général du visualiseur PDF :
| Constante | Valeur | Description |
|---|---|---|
QPdfView::PageMode::SinglePage | 0 | Affiche une page à la fois. |
QPdfView::PageMode::MultiPage | 1 | Permet de faire défiler toutes les pages du document. |
enum class QPdfView::ZoomMode
Cette énumération décrit le comportement d'agrandissement de la visionneuse PDF :
| Constante | Valeur | Description |
|---|---|---|
QPdfView::ZoomMode::Custom | 0 | Utiliser uniquement zoomFactor. |
QPdfView::ZoomMode::FitToWidth | 1 | Choisit automatiquement un facteur de zoom pour que la largeur de la page tienne dans la vue. |
QPdfView::ZoomMode::FitInView | 2 | Choisir automatiquement un facteur de zoom pour que la page entière s'adapte à la vue. |
Propriété Documentation
[since 6.6] currentSearchResultIndex : int
Si cette propriété est définie sur un nombre positif et que searchModel est défini, QPdfView dessine un cadre autour du résultat de la recherche fourni par QPdfSearchModel à l'index donné. Par exemple, si QPdfSearchModel est utilisé comme modèle pour QListView, vous pouvez maintenir cette propriété à jour en connectant QItemSelectionModel::currentChanged() de QListView::selectionModel() à une fonction qui appellera à son tour cette fonction.
Par défaut, il s'agit de -1, de sorte qu'aucun résultat de recherche n'est encadré.
Cette propriété a été introduite dans Qt 6.6.
Fonctions d'accès :
| int | currentSearchResultIndex() const |
| void | setCurrentSearchResultIndex(int currentResult) |
Signal Notifier :
| void | currentSearchResultIndexChanged(int currentResult) |
document : QPdfDocument*
Cette propriété contient le document à visualiser.
Fonctions d'accès :
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Signal de notification :
| void | documentChanged(QPdfDocument *document) |
documentMargins : QMargins
Cette propriété contient les marges autour de la vue de la page.
Fonctions d'accès :
| QMargins | documentMargins() const |
| void | setDocumentMargins(QMargins margins) |
Signal du notificateur :
| void | documentMarginsChanged(QMargins documentMargins) |
pageMode : PageMode
Cette propriété indique s'il faut afficher une page à la fois ou toutes les pages du document. La valeur par défaut est SinglePage.
Fonctions d'accès :
| QPdfView::PageMode | pageMode() const |
| void | setPageMode(QPdfView::PageMode mode) |
Signal de notification :
| void | pageModeChanged(QPdfView::PageMode pageMode) |
pageSpacing : int
Cette propriété définit la taille de l'espacement entre les pages du site MultiPage mode .
Fonctions d'accès :
| int | pageSpacing() const |
| void | setPageSpacing(int spacing) |
Signal de notification :
| void | pageSpacingChanged(int pageSpacing) |
[since 6.6] searchModel : QPdfSearchModel*
Si cette propriété est définie, QPdfView dessine des rectangles de surbrillance sur les résultats de recherche fournis par QPdfSearchModel::resultsOnPage(). Par défaut, il s'agit de nullptr.
Cette propriété a été introduite dans Qt 6.6.
Fonctions d'accès :
| QPdfSearchModel * | searchModel() const |
| void | setSearchModel(QPdfSearchModel *searchModel) |
Signal Notificateur :
| void | searchModelChanged(QPdfSearchModel *searchModel) |
zoomFactor : qreal
Cette propriété indique le rapport entre les pixels et les points. La valeur par défaut est 1, ce qui signifie qu'un point (1/72 de pouce) équivaut à 1 pixel logique.
Fonctions d'accès :
| qreal | zoomFactor() const |
| void | setZoomFactor(qreal factor) |
Signal de notification :
| void | zoomFactorChanged(qreal zoomFactor) |
zoomMode : ZoomMode
Cette propriété indique s'il faut utiliser une taille personnalisée pour la ou les pages ou les agrandir pour les adapter à la vue. La valeur par défaut est CustomZoom.
Fonctions d'accès :
| QPdfView::ZoomMode | zoomMode() const |
| void | setZoomMode(QPdfView::ZoomMode mode) |
Signal du notificateur :
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
Fonction membre Documentation
[explicit] QPdfView::QPdfView(QWidget *parent)
Construit une visionneuse PDF avec le widget parent parent.
[virtual noexcept] QPdfView::~QPdfView()
Détruit le visualiseur PDF.
QPdfPageNavigator *QPdfView::pageNavigator() const
Cet accesseur renvoie la pile de navigation qui gérera la navigation avant/arrière.
© 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.
