PdfSearchModel QML Type

A representation of text search results within a PDF Document. More...

Import Statement: import QtQuick.Pdf

Properties

Methods

Detailed Description

PdfSearchModel provides the ability to search for text strings within a document and get the geometric locations of matches on each page.

Property Documentation

count : int [since 6.8]

The number of search results found.

This property was introduced in Qt 6.8.


currentPage : int

The page on which currentResultBoundingPolygons should provide filtered search results.


currentPageBoundingPolygons : list<list<point>>

A set of paths in a form that can be bound to the paths property of a PathMultiline instance to render a batch of rectangles around all the regions where search results are found on currentPage:

PdfDocument {
    id: doc
}
PdfSearchModel {
    id: searchModel
    document: doc
}
Shape {
    ShapePath {
        PathMultiline {
            paths: searchModel.matchGeometry(view.currentPage)
        }
    }
}

See also PathMultiline.


currentResult : int

The result index within the whole set of search results, for which currentResultBoundingPolygons should provide the regions to highlight if currentPage matches currentResultLink.page.


currentResultBoundingPolygons : list<list<point>>

A set of paths in a form that can be bound to the paths property of a PathMultiline instance to render a batch of rectangles around the regions comprising the search result currentResult on currentPage. This is normally used to highlight one search result at a time, in a UI that allows stepping through the results:

PdfDocument {
    id: doc
}
PdfSearchModel {
    id: searchModel
    document: doc
    currentPage: view.currentPage
    currentResult: ...
}
Shape {
    ShapePath {
        PathMultiline {
            paths: searchModel.currentResultBoundingPolygons
        }
    }
}

It becomes empty whenever currentPage != currentResultLink.page.

See also PathMultiline.


currentResultBoundingRect : point

The bounding box containing all currentResultBoundingPolygons, if currentPage == currentResultLink.page; otherwise, an invalid rectangle.


The result at index currentResult.


searchString : string

The string to search for.


Method Documentation

list<list<point>> boundingPolygonsOnPage(int page)

Returns a set of paths in a form that can be bound to the paths property of a PathMultiline instance, which is used to render a batch of rectangles around all the matching locations on the page:

PdfDocument {
    id: doc
}
PdfSearchModel {
    id: searchModel
    document: doc
}
Shape {
    ShapePath {
        PathMultiline {
            paths: searchModel.matchGeometry(view.currentPage)
        }
    }
}

See also PathMultiline.


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