QPdfView Class
Ein PDF-Viewer-Widget. Mehr...
| Header: | #include <QPdfView> |
| Inherits: | QAbstractScrollArea |
Öffentliche Typen
Eigenschaften
|
|
Öffentliche Funktionen
| 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 |
Öffentliche Slots
| void | setCurrentSearchResultIndex(int currentResult) |
| void | setPageMode(QPdfView::PageMode mode) |
| void | setZoomFactor(qreal factor) |
| void | setZoomMode(QPdfView::ZoomMode mode) |
Signale
| 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) |
Detaillierte Beschreibung
QPdfView ist ein PDF-Viewer-Widget, das eine ähnliche Benutzererfahrung wie viele gängige PDF-Viewer-Anwendungen bietet, mit zwei modes. Im MultiPage Modus unterstützt es das Blättern durch die Seiten des gesamten Dokuments, mit schmalen Lücken zwischen den Seitenbildern. Im Modus SinglePage zeigt es eine Seite nach der anderen an.
Member Type Dokumentation
enum class QPdfView::PageMode
Diese Aufzählung beschreibt das allgemeine Verhalten des PDF-Viewers:
| Konstante | Wert | Beschreibung |
|---|---|---|
QPdfView::PageMode::SinglePage | 0 | Eine Seite nach der anderen anzeigen. |
QPdfView::PageMode::MultiPage | 1 | Erlaubt das Blättern durch alle Seiten des Dokuments. |
enum class QPdfView::ZoomMode
Diese Aufzählung beschreibt das Vergrößerungsverhalten des PDF-Viewers:
| Konstante | Wert | Beschreibung |
|---|---|---|
QPdfView::ZoomMode::Custom | 0 | Nur zoomFactor verwenden. |
QPdfView::ZoomMode::FitToWidth | 1 | Automatisch einen Zoomfaktor wählen, so dass die Breite der Seite in die Ansicht passt. |
QPdfView::ZoomMode::FitInView | 2 | Wählt automatisch einen Zoomfaktor, so dass die gesamte Seite in die Ansicht passt. |
Eigenschaft Dokumentation
[since 6.6] currentSearchResultIndex : int
Wenn diese Eigenschaft auf eine positive Zahl gesetzt ist und searchModel gesetzt ist, zeichnet QPdfView einen Rahmen um das von QPdfSearchModel gelieferte Suchergebnis am angegebenen Index. Wenn beispielsweise QPdfSearchModel als Modell für QListView verwendet wird, können Sie diese Eigenschaft aktualisieren, indem Sie QItemSelectionModel::currentChanged() von QListView::selectionModel() aus mit einer Funktion verbinden, die ihrerseits diese Funktion aufruft.
Standardmäßig ist es -1, so dass keine Suchergebnisse eingerahmt werden.
Diese Eigenschaft wurde in Qt 6.6 eingeführt.
Zugriffsfunktionen:
| int | currentSearchResultIndex() const |
| void | setCurrentSearchResultIndex(int currentResult) |
Notifier Signal:
| void | currentSearchResultIndexChanged(int currentResult) |
document : QPdfDocument*
Diese Eigenschaft enthält das zu betrachtende Dokument.
Zugriffsfunktionen:
| QPdfDocument * | document() const |
| void | setDocument(QPdfDocument *document) |
Benachrichtigungssignal:
| void | documentChanged(QPdfDocument *document) |
documentMargins : QMargins
Diese Eigenschaft enthält die Ränder um die Seitenansicht.
Zugriffsfunktionen:
| QMargins | documentMargins() const |
| void | setDocumentMargins(QMargins margins) |
Benachrichtigungssignal:
| void | documentMarginsChanged(QMargins documentMargins) |
pageMode : PageMode
Diese Eigenschaft legt fest, ob jeweils eine Seite oder alle Seiten des Dokuments angezeigt werden sollen. Die Standardeinstellung ist SinglePage.
Zugriffsfunktionen:
| QPdfView::PageMode | pageMode() const |
| void | setPageMode(QPdfView::PageMode mode) |
Benachrichtigungssignal:
| void | pageModeChanged(QPdfView::PageMode pageMode) |
pageSpacing : int
Diese Eigenschaft bestimmt die Größe des Abstandes zwischen den Seiten in MultiPage mode .
Zugriffsfunktionen:
| int | pageSpacing() const |
| void | setPageSpacing(int spacing) |
Benachrichtigungssignal:
| void | pageSpacingChanged(int pageSpacing) |
[since 6.6] searchModel : QPdfSearchModel*
Wenn diese Eigenschaft gesetzt ist, zeichnet QPdfView hervorgehobene Rechtecke über die von QPdfSearchModel::resultsOnPage() gelieferten Suchergebnisse. Standardmäßig ist sie auf nullptr gesetzt.
Diese Eigenschaft wurde in Qt 6.6 eingeführt.
Zugriffsfunktionen:
| QPdfSearchModel * | searchModel() const |
| void | setSearchModel(QPdfSearchModel *searchModel) |
Benachrichtigungssignal:
| void | searchModelChanged(QPdfSearchModel *searchModel) |
zoomFactor : qreal
Diese Eigenschaft gibt das Verhältnis von Pixeln zu Punkten an. Der Standardwert ist 1, was bedeutet, dass ein Punkt (1/72 Zoll) 1 logischem Pixel entspricht.
Zugriffsfunktionen:
| qreal | zoomFactor() const |
| void | setZoomFactor(qreal factor) |
Melder-Signal:
| void | zoomFactorChanged(qreal zoomFactor) |
zoomMode : ZoomMode
Diese Eigenschaft gibt an, ob eine benutzerdefinierte Größe für die Seite(n) verwendet werden soll, oder ob sie gezoomt werden sollen, um in die Ansicht zu passen. Die Standardeinstellung ist CustomZoom.
Zugriffsfunktionen:
| QPdfView::ZoomMode | zoomMode() const |
| void | setZoomMode(QPdfView::ZoomMode mode) |
Benachrichtigungssignal:
| void | zoomModeChanged(QPdfView::ZoomMode zoomMode) |
Member Function Dokumentation
[explicit] QPdfView::QPdfView(QWidget *parent)
Konstruiert einen PDF-Viewer mit dem übergeordneten Widget parent.
[virtual noexcept] QPdfView::~QPdfView()
Zerstört den PDF-Viewer.
QPdfPageNavigator *QPdfView::pageNavigator() const
Dieser Accessor gibt den Navigationsstapel zurück, der die Rückwärts-/Vorwärtsnavigation übernimmt.
© 2025 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.
