Back to Qt.io
Contact Us Blog Download Qt

PdfSelection QML Type

Eine Darstellung einer Textauswahl innerhalb eines PDF-Dokuments. Mehr...

Import Statement: import QtQuick.Pdf
Inherits:

Item

Eigenschaften

Methoden

Detaillierte Beschreibung

PdfSelection stellt die Textzeichenfolge und ihre Geometrie innerhalb eines Begrenzungsrahmens von einem Punkt zum anderen bereit.

Um die Auswahl mit der Maus zu ändern, binden Sie from und to an die entsprechenden Eigenschaften eines Input-Handlers, so dass sie auf die Positionen gesetzt werden, an denen die Ziehgeste beginnt bzw. endet; und binden Sie die Eigenschaft hold, so dass sie während der Ziehgeste auf true gesetzt wird und auf false, wenn die Geste endet.

PdfSelection verarbeitet auch direkt Abfragen der Eingabemethode, so dass Textauswahlgriffe auf Plattformen wie iOS verwendet werden können. Zu diesem Zweck muss sie den Tastaturfokus haben.

Eigenschaft Documentation

document : PdfDocument

Diese Eigenschaft enthält das PDF-Dokument, in dem der Text ausgewählt werden soll.


from : point

Die Anfangsposition in Pixeln von der oberen linken Ecke der Seite, ab der der ausgewählte Text gesucht werden soll. Diese Eigenschaft kann an die centroid.pressPosition einer DragHandler gebunden werden, um die Textauswahl an der Position zu beginnen, an der der Benutzer die Maustaste drückt und mit dem Ziehen beginnt.


geometry : list<list<point>>

Ein Satz von Pfaden in einem Formular, der an die paths Eigenschaft einer PathMultiline Instanz gebunden werden kann, um einen Stapel von Rechtecken um die Textregionen zu rendern, die in der Auswahl enthalten sind:

PdfDocument {
    id: doc
}
PdfSelection {
    id: selection
    document: doc
    from: textSelectionDrag.centroid.pressPosition
    to: textSelectionDrag.centroid.position
    hold: !textSelectionDrag.active
}
Shape {
    ShapePath {
        PathMultiline {
            paths: selection.geometry
        }
    }
}
DragHandler {
    id: textSelectionDrag
    acceptedDevices: PointerDevice.Mouse | PointerDevice.Stylus
    target: null
}

Siehe auch PathMultiline.


hold : bool

Legt fest, ob die vorhandene Auswahl unabhängig von Änderungen an from und to beibehalten werden soll. Diese Eigenschaft kann auf true gesetzt werden, wenn die Maus oder der Touchpoint losgelassen wird, so dass die Auswahl nicht verloren geht, wenn sich die Punktbindungen ändern.


page : int

Die Seitennummer, auf der gesucht werden soll.

Siehe auch QtQuick::Image::currentFrame.


renderScale : real

Das Verhältnis von Punkten zu Pixeln, in dem die Seite gerendert wird.

Dies wird für die Skalierung von from und to verwendet, um Bereiche ausgewählter Zeichen im Dokument zu finden, da die Positionen innerhalb des Dokuments immer in Punkten angegeben werden.


text : string

Der Text, der in dem rechteckigen Bereich zwischen from und to gefunden wurde, oder der gesamte Text auf page, wenn selectAll() aufgerufen wurde.


to : point

Die Endposition in Pixeln von der linken oberen Ecke der Seite, ab der der ausgewählte Text gesucht werden soll. Dies kann an die centroid.position eines DragHandler gebunden werden, um die Auswahl des Textes an der Position zu beenden, an der der Benutzer gerade die Maus zieht.


Methode Dokumentation

void clear()

Löscht die aktuelle Auswahl.


void copyToClipboard()

Kopiert reinen Text aus der Eigenschaft text in die Systemzwischenablage.


void selectAll()

Markiert den gesamten Text auf der aktuellen page.


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