En esta página

QPdfSearchModel Class

La clase QPdfSearchModel busca una cadena en un documento PDF y guarda los resultados. Más...

Header: #include <QPdfSearchModel>
Inherits: QAbstractListModel

Tipos públicos

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

Propiedades

Funciones públicas

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

Funciones públicas reimplementadas

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

Ranuras públicas

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

Señales

Descripción detallada

Se utiliza en el paradigma de programación Modelo/Vista para mostrar una lista de resultados de búsqueda, resaltarlos en las páginas PDF renderizadas e iterar a través de ellos utilizando los botones "buscar hacia delante" / "buscar hacia atrás" y los accesos directos que se encontrarían en una interfaz de usuario típica de visualización de documentos:

Visor de PDF con panel de resultados de búsqueda que muestra entradas para "arena" y el resultado resaltado en la página.

Tipo de miembro Documentación

enum class QPdfSearchModel::Role

ConstanteValorDescripción
QPdfSearchModel::Role::PageQt::UserRoleEl número de página donde se encuentra el resultado de la búsqueda (int).
QPdfSearchModel::Role::IndexOnPage257El índice del resultado de la búsqueda en la página (int).
QPdfSearchModel::Role::Location258La posición del resultado de la búsqueda en la página (QPointF).
QPdfSearchModel::Role::ContextBefore259El texto adyacente en la página, antes de la cadena de búsqueda (QString).
QPdfSearchModel::Role::ContextAfter260El texto adyacente en la página, después de la cadena de búsqueda (QString).

Véase también QPdfLink.

Documentación de propiedades

[read-only, since 6.8] count : int

Esta propiedad contiene el número de resultados de búsqueda encontrados

Esta propiedad se introdujo en Qt 6.8.

Funciones de acceso:

int count() const

Señal de notificador:

void countChanged()

document : QPdfDocument*

Esta propiedad contiene el documento a buscar

Funciones de acceso:

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

Señal del notificador:

void documentChanged()

searchString : QString

Esta propiedad contiene la cadena a buscar

Funciones de acceso:

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

Señal del notificador:

void searchStringChanged()

Documentación de la función miembro

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

Construye un nuevo modelo de búsqueda con el objeto padre parent.

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

Destruye el modelo.

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

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

QPdfLink QPdfSearchModel::resultAtIndex(int index) const

Devuelve un resultado encontrado por index en document, independientemente de la página en la que se haya encontrado. index debe ser menor que rowCount.

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

Devuelve la lista de todos los resultados encontrados en la dirección page.

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

Reimplementa: QAbstractItemModel::roleNames() const.

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

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

El número de filas del modelo es igual al número de resultados de búsqueda encontrados.

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