QTextBrowser Class

Dokumentation der Member-Funktionen

[explicit] QTextBrowser::QTextBrowser(QWidget *parent = nullptr)

Erstellt einen leeren QTextBrowser mit dem übergeordneten Element „ parent “.

[signal] void QTextBrowser::anchorClicked(const QUrl &link)

Dieses Signal wird ausgelöst, wenn der Benutzer auf einen Anker klickt. Die URL, auf die der Anker verweist, wird in „ link “ übergeben.

Beachten Sie, dass der Browser die Navigation zu der durch „ link “ angegebenen Adresse automatisch übernimmt, es sei denn, die Eigenschaft „ openLinks “ ist auf „false“ gesetzt oder Sie rufen „ setSource()“ in einem verbundenen Slot auf. Dieser Mechanismus wird verwendet, um die Standard-Navigationsfunktionen des Browsers zu überschreiben.

[virtual slot] void QTextBrowser::backward()

Wechselt das angezeigte Dokument zum vorherigen Dokument in der Liste der Dokumente, die durch das Navigieren über Links erstellt wurde. Es geschieht nichts, wenn kein vorheriges Dokument vorhanden ist.

Siehe auch forward() und backwardAvailable().

[signal] void QTextBrowser::backwardAvailable(bool available)

Dieses Signal wird ausgelöst, wenn sich die Verfügbarkeit von backward() ändert. available ist „false“, wenn sich der Benutzer unter home() befindet; andernfalls ist es „true“.

int QTextBrowser::backwardHistoryCount() const

Gibt die Anzahl der Positionen zurück, die man im Verlauf rückwärts zurückgehen muss.

void QTextBrowser::clearHistory()

Löscht den Verlauf der aufgerufenen Dokumente und deaktiviert die Navigation vorwärts und rückwärts.

Siehe auch backward() und forward().

[virtual protected] void QTextBrowser::doSetSource(const QUrl &url, QTextDocument::ResourceType type = QTextDocument::UnknownResource)

Es wird versucht, das Dokument unter der angegebenen Adresse url mit der angegebenen URL type zu laden.

setSource() ruft doSetSource auf. In Qt 5 war setSource(const QUrl &url) virtuell. In Qt 6 ist stattdessen doSetSource() virtuell, sodass es in Unterklassen überschrieben werden kann.

[override virtual protected] bool QTextBrowser::event(QEvent *e)

Umsetzt: ` QAbstractScrollArea::event(QEvent *event)`.

[override virtual protected] bool QTextBrowser::focusNextPrevChild(bool next)

Implementiert: ` QTextEdit::focusNextPrevChild` (bool next).

[override virtual protected] void QTextBrowser::focusOutEvent(QFocusEvent *ev)

Umsetzt: ` QTextEdit::focusOutEvent(QFocusEvent *e)`.

[virtual slot] void QTextBrowser::forward()

Wechselt das angezeigte Dokument zum nächsten Dokument in der Liste der Dokumente, die durch das Navigieren über Links erstellt wurde. Führt keine Aktion aus, wenn kein nächstes Dokument vorhanden ist.

Siehe auch backward() und forwardAvailable().

[signal] void QTextBrowser::forwardAvailable(bool available)

Dieses Signal wird ausgelöst, wenn sich die Verfügbarkeit von „ forward “ () ändert. „ available “ ist wahr, nachdem der Benutzer zu „ backward “ () navigiert ist, und falsch, wenn der Benutzer zu „ forward “ () navigiert oder diese Seite verlässt.

int QTextBrowser::forwardHistoryCount() const

Gibt die Anzahl der Positionen in der Historie zurück, die in die Zukunft reichen.

[signal] void QTextBrowser::highlighted(const QUrl &link)

Dieses Signal wird ausgelöst, wenn der Benutzer einen Anker im Dokument ausgewählt, aber noch nicht aktiviert hat. Die URL, auf die der Anker verweist, wird in „ link “ übergeben.

[signal] void QTextBrowser::historyChanged()

Dieses Signal wird ausgegeben, wenn sich der Verlauf ändert.

Siehe auch historyTitle() und historyUrl().

QString QTextBrowser::historyTitle(int i) const

Gibt die ` documentTitle()` des `HistoryItem` zurück.

backaction.setToolTip(browser.historyTitle(-1));
forwardaction.setToolTip(browser.historyTitle(+1));

QUrl QTextBrowser::historyUrl(int i) const

Gibt die URL des HistoryItem zurück.

[virtual slot] void QTextBrowser::home()

Wechselt das angezeigte Dokument zum ersten Dokument aus dem Verlauf.

bool QTextBrowser::isBackwardAvailable() const

Gibt „ true “ zurück, wenn der Textbrowser mithilfe von „ backward()“ im Dokumentverlauf zurückblättern kann.

Siehe auch „ backwardAvailable()“ und „ backward()“.

bool QTextBrowser::isForwardAvailable() const

Gibt „ true “ zurück, wenn der Textbrowser mithilfe von „ forward()“ im Dokumentverlauf vorwärts blättern kann.

Siehe auch „ forwardAvailable()“ und „ forward()“.

[override virtual protected] void QTextBrowser::keyPressEvent(QKeyEvent *ev)

Implementiert: ` QTextEdit::keyPressEvent(QKeyEvent *e)`.

Das Ereignis ` ev ` wird verwendet, um die folgenden Tastaturkürzel bereitzustellen:

[override virtual] QVariant QTextBrowser::loadResource(int type, const QUrl &name)

Umsetzt: QTextEdit::loadResource(int type, const QUrl &name).

Diese Funktion wird beim Laden des Dokuments sowie für jedes Bild im Dokument aufgerufen. Der Parameter „ type “ gibt den Typ der zu ladenden Ressource an. Wenn die Ressource nicht geladen werden kann, wird ein ungültiger „ QVariant “ zurückgegeben.

Die Standardimplementierung ignoriert „ type “ und versucht, die Ressourcen zu finden, indem sie „ name “ als Dateinamen interpretiert. Handelt es sich nicht um einen absoluten Pfad, versucht sie, die Datei in den Pfaden der Eigenschaft „ searchPaths “ sowie im selben Verzeichnis wie die aktuelle Quelle zu finden. Bei Erfolg ist das Ergebnis ein „ QVariant “, der ein „ QByteArray “ mit dem Inhalt der Datei enthält.

Wenn Sie diese Funktion neu implementieren, können Sie andere „ QVariant “-Typen zurückgeben. Die folgende Tabelle zeigt, welche Varianten je nach Ressourcentyp unterstützt werden:

[override virtual protected] void QTextBrowser::mouseMoveEvent(QMouseEvent *e)

Implementiert: QTextEdit::mouseMoveEvent(QMouseEvent *e).

[override virtual protected] void QTextBrowser::mousePressEvent(QMouseEvent *e)

Implementiert: ` QTextEdit::mousePressEvent(QMouseEvent *e)`.

[override virtual protected] void QTextBrowser::mouseReleaseEvent(QMouseEvent *e)

Implementiert neu: ` QTextEdit::mouseReleaseEvent(QMouseEvent *e)`.

[override virtual protected] void QTextBrowser::paintEvent(QPaintEvent *e)

Umsetzt: ` QTextEdit::paintEvent` (`QPaintEvent *event`).

[virtual slot] void QTextBrowser::reload()

Lädt die aktuelle Quelle neu.

[slot] void QTextBrowser::setSource(const QUrl &url, QTextDocument::ResourceType type = QTextDocument::UnknownResource)

Es wird versucht, das Dokument unter der angegebenen Adresse url mit dem angegebenen Dokumenttyp type zu laden.

Wenn type gleich UnknownResource ist (Standard), wird der Dokumenttyp erkannt: Das heißt, wenn die URL mit einer Erweiterung wie .md, .mkd oder .markdown endet, wird das Dokument über QTextDocument::setMarkdown() geladen; andernfalls wird es über QTextDocument::setHtml() geladen. Diese Erkennung kann umgangen werden, indem type explizit angegeben wird.

Siehe auch ` source()`.

[signal] void QTextBrowser::sourceChanged(const QUrl &src)

Dieses Signal wird ausgelöst, wenn sich die Quelle geändert hat, wobei src die neue Quelle ist.

Quellenwechsel erfolgen sowohl programmgesteuert beim Aufruf von ` setSource()`, ` forward()`, ` backward()` oder ` home()` als auch, wenn der Benutzer auf Links klickt oder die entsprechenden Tastenkombinationen drückt.