QPdfSearchModel Class

The QPdfSearchModel class searches for a string in a PDF document and holds the results. More...

Header: #include <QPdfSearchModel>
Since: Qt 5.15
Inherits: QAbstractListModel

Public Types

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


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)


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

QPdfSearchModel::Role::PageQt::UserRoleThe page number where the search result is found (int).
QPdfSearchModel::Role::IndexOnPage257The index of the search result on the page (int).
QPdfSearchModel::Role::Location258The position of the search result on the page (QPointF).
QPdfSearchModel::Role::ContextBefore259The adjacent text on the page, before the search string (QString).
QPdfSearchModel::Role::ContextAfter260The 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

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.

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