QPdfSearchModel Class
The QPdfSearchModel class searches for a string in a PDF document and holds the results. More...
Header: | #include <QPdfSearchModel> |
Inherits: | QAbstractListModel |
Public Types
enum class | Role { Page, IndexOnPage, Location, ContextBefore, ContextAfter } |
Properties
- document : QPdfDocument*
- searchString : QString
Public Functions
QPdfSearchModel(QObject *parent) | |
virtual | ~QPdfSearchModel() override |
QPdfDocument * | document() const |
QPdfLink | resultAtIndex(int index) const |
QList<QPdfLink> | resultsOnPage(int page) const |
QString | searchString() const |
Reimplemented Public Functions
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 |
Public Slots
void | setDocument(QPdfDocument *document) |
void | setSearchString(const QString &searchString) |
Signals
void | documentChanged() |
void | searchStringChanged() |
Detailed Description
This is used in the Model/View Programming paradigm to display a list of search results, to highlight them on the rendered PDF pages, and to iterate through them using the "search forward" / "search backward" buttons and shortcuts that would be found in a typical document-viewing UI:
Member Type Documentation
enum class QPdfSearchModel::Role
Constant | Value | Description |
---|---|---|
QPdfSearchModel::Role::Page | Qt::UserRole | The page number where the search result is found (int). |
QPdfSearchModel::Role::IndexOnPage | 257 | The index of the search result on the page (int). |
QPdfSearchModel::Role::Location | 258 | The position of the search result on the page (QPointF). |
QPdfSearchModel::Role::ContextBefore | 259 | The adjacent text on the page, before the search string (QString). |
QPdfSearchModel::Role::ContextAfter | 260 | The adjacent text on the page, after the search string (QString). |
See also QPdfLink.
Property Documentation
document : QPdfDocument*
This property holds the document to search
Access functions:
QPdfDocument * | document() const |
void | setDocument(QPdfDocument *document) |
Notifier signal:
void | documentChanged() |
searchString : QString
This property holds the string to search for
Access functions:
QString | searchString() const |
void | setSearchString(const QString &searchString) |
Notifier signal:
void | searchStringChanged() |
Member Function Documentation
[explicit]
QPdfSearchModel::QPdfSearchModel(QObject *parent)
Constructs a new search model with parent object parent.
[override virtual]
QPdfSearchModel::~QPdfSearchModel()
Destroys the model.
[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
Returns a result found by index in the document, regardless of the page on which it was found. index must be less than rowCount.
QList<QPdfLink> QPdfSearchModel::resultsOnPage(int page) const
Returns the list of all results found on the given page.
[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.
The number of rows in the model is equal to the number of search results found.
© 2023 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.