QPdfLink Class

Die Klasse QPdfLink definiert eine Verknüpfung zwischen einem Bereich auf einer Seite (z. B. einem Hyperlink oder einem Suchergebnis) und einem Ziel (Seite, Position auf der Seite und Zoomstufe, mit der die Seite angezeigt wird). Mehr...

Header: #include <QPdfLink>
Since: Qt 6.4

Eigenschaften

Öffentliche Funktionen

QPdfLink()
QString contextAfter() const
QString contextBefore() const
void copyToClipboard(QClipboard::Mode mode = QClipboard::Clipboard) const
bool isValid() const
QPointF location() const
int page() const
QList<QRectF> rectangles() const
QString toString() const
QUrl url() const
qreal zoom() const

Detaillierte Beschreibung

Dokumentation der Eigenschaften

[read-only] contextAfter : const QString

Diese Eigenschaft enthält angrenzenden Text, der auf der Seite nach dem Suchbegriff gefunden wird. Handelt es sich bei dem Link um einen Hyperlink, ist diese Zeichenfolge leer.

Zugriffsfunktionen:

QString contextAfter() const

Siehe auch QPdfSearchModel::resultsOnPage() und QPdfSearchModel::resultAtIndex().

[read-only] contextBefore : const QString

Diese Eigenschaft enthält angrenzenden Text, der auf der Seite vor dem Suchbegriff gefunden wurde. Handelt es sich bei dem Link um einen Hyperlink, ist diese Zeichenfolge leer.

Zugriffsfunktionen:

QString contextBefore() const

Siehe auch QPdfSearchModel::resultsOnPage() und QPdfSearchModel::resultAtIndex().

[read-only] location : const QPointF

Diese Eigenschaft enthält die Position auf der Website page in Punkteinheiten. Handelt es sich bei dem Link um ein Suchergebnis, ist es der Ort, an dem das Ergebnis gefunden wurde; handelt es sich um einen Hyperlink, ist es der Zielort.

Zugriffsfunktionen:

QPointF location() const

[read-only] page : const int

Diese Eigenschaft enthält die Seitenzahl. Handelt es sich bei dem Link um ein Suchergebnis, ist dies die Seitennummer, auf der das Ergebnis gefunden wurde; handelt es sich um einen Hyperlink, ist es die Nummer der Zielseite.

Zugriffsfunktionen:

int page() const

[read-only] rectangles : const QList<QRectF>

Diese Eigenschaft enthält den Bereich (eine Reihe von Rechtecken), den der Link oder das Suchergebnis auf der Seite einnimmt, auf der es gefunden wurde. Wenn sich der Text über mehrere Zeilen auf der Seite erstreckt, kann es mehrere Rechtecke geben:

Zugriffsfunktionen:

QList<QRectF> rectangles() const

Siehe auch QPdfSearchModel::resultsOnPage() und QPdfSearchModel::resultAtIndex().

[read-only] url : const QUrl

Diese Eigenschaft enthält die Ziel-URL, wenn es sich bei dem Link um einen externen Hyperlink handelt; andernfalls ist sie leer.

Zugriffsfunktionen:

QUrl url() const

[read-only] valid : const bool

Diese Eigenschaft gibt an, ob die Verknüpfung gültig ist.

Zugriffsfunktionen:

bool isValid() const

[read-only] zoom : const qreal

Diese Eigenschaft enthält die vorgeschlagene Vergrößerungsstufe, wobei 1,0 den Standardmaßstab (1 Pixel = 1 Punkt) bedeutet. Wenn der Link ein Suchergebnis ist, wird dieser Wert nicht verwendet.

Zugriffsfunktionen:

qreal zoom() const

Dokumentation der Mitgliedsfunktionen

Konstruiert ein ungültiges Ziel.

Siehe auch valid.

[invokable] void QPdfLink::copyToClipboard(QClipboard::Mode mode = QClipboard::Clipboard) const

Kopiert die toString()-Darstellung des Links auf die system clipboard in Abhängigkeit von der angegebenen mode.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

[invokable] QString QPdfLink::toString() const

Gibt eine übersetzte Darstellung zur Anzeige zurück.

Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.

Siehe auch copyToClipboard().

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