QPdfSearchModel Class

Die Klasse QPdfSearchModel sucht nach einer Zeichenkette in einem PDF-Dokument und hält die Ergebnisse fest. Mehr...

Header: #include <QPdfSearchModel>
Inherits: QAbstractListModel

Öffentliche Typen

enum class Role { Page, IndexOnPage, Location, ContextBefore, ContextAfter }

Eigenschaften

Öffentliche Funktionen

QPdfSearchModel(QObject *parent)
virtual ~QPdfSearchModel() override
int count() const
QPdfDocument *document() const
QPdfLink resultAtIndex(int index) const
QList<QPdfLink> resultsOnPage(int page) const
QString searchString() const

Reimplementierte öffentliche Funktionen

virtual QVariant data(const QModelIndex &index, int role) const override
virtual QHash<int, QByteArray> roleNames() const override
virtual int rowCount(const QModelIndex &parent) const override

Öffentliche Slots

void setDocument(QPdfDocument *document)
void setSearchString(const QString &searchString)

Signale

Detaillierte Beschreibung

Diese Funktion wird im Paradigma der Model/View-Programmierung verwendet, um eine Liste von Suchergebnissen anzuzeigen, sie auf den gerenderten PDF-Seiten hervorzuheben und sie mit Hilfe der Schaltflächen "Suche vorwärts" / "Suche rückwärts" und Verknüpfungen, die in einer typischen Benutzeroberfläche für die Dokumentenanzeige zu finden sind, zu durchlaufen:

Mitgliedstyp Dokumentation

enum class QPdfSearchModel::Role

KonstanteWertBeschreibung
QPdfSearchModel::Role::PageQt::UserRoleDie Seitennummer, auf der sich das Suchergebnis befindet (int).
QPdfSearchModel::Role::IndexOnPage257Der Index des Suchergebnisses auf der Seite (int).
QPdfSearchModel::Role::Location258Die Position des Suchergebnisses auf der Seite (QPointF).
QPdfSearchModel::Role::ContextBefore259Der angrenzende Text auf der Seite, vor dem Suchstring (QString).
QPdfSearchModel::Role::ContextAfter260Der angrenzende Text auf der Seite, nach dem Suchbegriff (QString).

Siehe auch QPdfLink.

Eigenschaft Dokumentation

[read-only, since 6.8] count : const int

Diese Eigenschaft enthält die Anzahl der gefundenen Suchergebnisse

Diese Eigenschaft wurde in Qt 6.8 eingeführt.

Zugriffsfunktionen:

int count() const

Benachrichtigungssignal:

void countChanged()

document : QPdfDocument*

Diese Eigenschaft enthält das zu durchsuchende Dokument

Zugriffsfunktionen:

QPdfDocument *document() const
void setDocument(QPdfDocument *document)

Benachrichtigungssignal:

void documentChanged()

searchString : QString

Diese Eigenschaft enthält die Zeichenfolge, nach der gesucht werden soll

Zugriffsfunktionen:

QString searchString() const
void setSearchString(const QString &searchString)

Benachrichtigungssignal:

void searchStringChanged()

Dokumentation der Mitgliedsfunktionen

[explicit] QPdfSearchModel::QPdfSearchModel(QObject *parent)

Konstruiert ein neues Suchmodell mit dem übergeordneten Objekt parent.

[override virtual noexcept] QPdfSearchModel::~QPdfSearchModel()

Zerstört das Modell.

[override virtual] QVariant QPdfSearchModel::data(const QModelIndex &index, int role) const

Reimplements: QAbstractItemModel::data(const QModelIndex &index, int role) const.

QPdfLink QPdfSearchModel::resultAtIndex(int index) const

Gibt ein Ergebnis zurück, das von index in der document gefunden wurde, unabhängig von der Seite, auf der es gefunden wurde. index muss kleiner sein als rowCount.

QList<QPdfLink> QPdfSearchModel::resultsOnPage(int page) const

Gibt die Liste aller Ergebnisse zurück, die unter der angegebenen Adresse page gefunden wurden.

[override virtual] QHash<int, QByteArray> QPdfSearchModel::roleNames() const

Reimplements: QAbstractItemModel::roleNames() const.

[override virtual] int QPdfSearchModel::rowCount(const QModelIndex &parent) const

Reimplements: QAbstractItemModel::rowCount(const QModelIndex &parent) const.

Die Anzahl der Zeilen des Modells ist gleich der Anzahl der gefundenen Suchergebnisse.

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