Sur cette page

QPdfSearchModel Class

La classe QPdfSearchModel recherche une chaîne de caractères dans un document PDF et conserve les résultats. Plus d'informations...

Header: #include <QPdfSearchModel>
Inherits: QAbstractListModel

Types publics

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

Propriétés

Fonctions publiques

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

Fonctions publiques réimplémentées

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

Emplacements publics

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

Signaux

Description détaillée

Elle est utilisée dans le paradigme de programmation Modèle/Vue pour afficher une liste de résultats de recherche, les mettre en évidence sur les pages PDF rendues, et les parcourir en utilisant les boutons "recherche avant" / "recherche arrière" et les raccourcis que l'on trouverait dans une interface utilisateur typique de visualisation de documents :

Visionneuse PDF avec panneau de résultats de recherche affichant les entrées pour "sable" et les résultats surlignés sur la page

Type de membre Documentation

enum class QPdfSearchModel::Role

ConstanteValeurDescription
QPdfSearchModel::Role::PageQt::UserRoleLe numéro de la page où se trouve le résultat de la recherche (int).
QPdfSearchModel::Role::IndexOnPage257L'index du résultat de la recherche sur la page (int).
QPdfSearchModel::Role::Location258La position du résultat de la recherche sur la page (QPointF).
QPdfSearchModel::Role::ContextBefore259Le texte adjacent sur la page, avant la chaîne de recherche (QString).
QPdfSearchModel::Role::ContextAfter260Le texte adjacent sur la page, après la chaîne de recherche (QString).

Voir également QPdfLink.

Documentation sur les propriétés

[read-only, since 6.8] count : int

Cette propriété contient le nombre de résultats de recherche trouvés

Cette propriété a été introduite dans Qt 6.8.

Fonctions d'accès :

int count() const

Signal Notificateur :

void countChanged()

document : QPdfDocument*

Cette propriété contient le document à rechercher

Fonctions d'accès :

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

Signal de notification :

void documentChanged()

searchString : QString

Cette propriété contient la chaîne de caractères à rechercher

Fonctions d'accès :

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

Signal du notificateur :

void searchStringChanged()

Fonction membre Documentation

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

Construit un nouveau modèle de recherche avec l'objet parent parent.

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

Détruit le modèle.

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

Réimplémente : QAbstractItemModel::data(const QModelIndex &index, int role) const.

QPdfLink QPdfSearchModel::resultAtIndex(int index) const

Renvoie un résultat trouvé par index dans le site document, quelle que soit la page sur laquelle il a été trouvé. index doit être inférieur à rowCount.

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

Renvoie la liste de tous les résultats trouvés sur le site page.

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

Réimplémente : QAbstractItemModel::roleNames() const.

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

Réimplémente : QAbstractItemModel::rowCount(const QModelIndex &parent) const.

Le nombre de lignes du modèle est égal au nombre de résultats de recherche trouvés.

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