PdfSelection QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• document : PdfDocument
• from : point
• geometry : list<list<point>>
• hold : bool
• page : int
• renderScale : real
• text : string
• to : point

Methoden

• void clear()
• void copyToClipboard()
• void selectAll()

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.

Dokumentation der Eigenschaft

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 linken oberen Ecke der Seite, ab der der ausgewählte Text gesucht werden soll. Dies kann an die Adresse centroid.pressPosition einer DragHandler gebunden werden, damit die Textauswahl an der Position beginnt, an der der Benutzer die Maustaste drückt und mit dem Ziehen beginnt.

geometry : list<list<point>>

Eine Reihe von Pfaden in einer Form, die an die Eigenschaft paths einer Instanz von PathMultiline gebunden werden kann, um einen Stapel von Rechtecken um die Textbereiche 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

Steuert, ob die bestehende 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, weil sich die Punktbindungen ändern.

page : int

Die Seitenzahl, 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 aus, an der der ausgewählte Text gefunden werden soll. Dies kann an die centroid.position einer DragHandler gebunden werden, um die Auswahl des Textes an der Position zu beenden, an der der Benutzer gerade die Maus zieht.

Dokumentation der Methode

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 Seite page.