PySide6.QtPdf.QPdfSearchModel

class 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

Methods

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

Note

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

property countᅟ: int

This property holds the number of search results found.

Access functions:
property documentᅟ: QPdfDocument

This property holds the document to search.

Access functions:
property searchStringᅟ: str

This property holds the string to search for.

Access functions:
__init__()
__init__(parent)
Parameters:

parentQObject

Constructs a new search model with parent object parent.

count()
Return type:

int

Getter of property countᅟ .

countChanged()

Notification signal of property countᅟ .

document()
Return type:

QPdfDocument

See also

setDocument()

Getter of property documentᅟ .

documentChanged()

Notification signal of property documentᅟ .

resultAtIndex(index)
Parameters:

index – int

Return type:

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 .

resultsOnPage(page)
Parameters:

page – int

Return type:

.list of QPdfLink

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

searchString()
Return type:

str

Getter of property searchStringᅟ .

searchStringChanged()

Notification signal of property searchStringᅟ .

setDocument(document)
Parameters:

documentQPdfDocument

See also

document()

Setter of property documentᅟ .

setSearchString(searchString)
Parameters:

searchString – str

See also

searchString()

Setter of property searchStringᅟ .

updatePage(page)
Parameters:

page – int