QPdfSearchModel#

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

Inheritance diagram of PySide6.QtPdf.QPdfSearchModel

Synopsis#

Properties#

Functions#

Slots#

Signals#

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

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:

../../_images/search-results.png
class PySide6.QtPdf.QPdfSearchModel#

PySide6.QtPdf.QPdfSearchModel(parent)

Parameters:

parentPySide6.QtCore.QObject

Constructs a new search model with parent object parent.

Note

Properties can be used directly when from __feature__ import true_property is used or via accessor functions otherwise.

property PᅟySide6.QtPdf.QPdfSearchModel.document: PySide6.QtPdf.QPdfDocument#

This property holds the document to search.

Access functions:
property PᅟySide6.QtPdf.QPdfSearchModel.searchString: str#

This property holds the string to search for.

Access functions:
PySide6.QtPdf.QPdfSearchModel.Role#

Constant

Description

QPdfSearchModel.Role.Page

The page number where the search result is found (int).

QPdfSearchModel.Role.IndexOnPage

The index of the search result on the page (int).

QPdfSearchModel.Role.Location

The position of the search result on the page ( QPointF ).

QPdfSearchModel.Role.ContextBefore

The adjacent text on the page, before the search string ( QString ).

QPdfSearchModel.Role.ContextAfter

The adjacent text on the page, after the search string ( QString ).

See also

QPdfLink

PySide6.QtPdf.QPdfSearchModel.document()#
Return type:

PySide6.QtPdf.QPdfDocument

See also

setDocument()

Getter of property document .

PySide6.QtPdf.QPdfSearchModel.documentChanged()#

Notification signal of property document .

PySide6.QtPdf.QPdfSearchModel.resultAtIndex(index)#
Parameters:

index – int

Return type:

PySide6.QtPdf.QPdfLink

Returns a result found by index in the document , regardless of the page on which it was found. index must be less than rowCount .

PySide6.QtPdf.QPdfSearchModel.resultsOnPage(page)#
Parameters:

page – int

Return type:

Returns the list of all results found on the given page.

PySide6.QtPdf.QPdfSearchModel.searchString()#
Return type:

str

Getter of property searchString .

PySide6.QtPdf.QPdfSearchModel.searchStringChanged()#

Notification signal of property searchString .

PySide6.QtPdf.QPdfSearchModel.setDocument(document)#
Parameters:

documentPySide6.QtPdf.QPdfDocument

See also

document()

Setter of property document .

PySide6.QtPdf.QPdfSearchModel.setSearchString(searchString)#
Parameters:

searchString – str

See also

searchString()

Setter of property searchString .

PySide6.QtPdf.QPdfSearchModel.updatePage(page)#
Parameters:

page – int