QWebEngineView Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert eine leere Webansicht mit dem übergeordneten parent.

Siehe auch load().

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEnginePage *page, QWidget *parent = nullptr)

Konstruiert eine Webansicht, die page mit dem übergeordneten parent enthält.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch load() und setPage().

[explicit, since 6.4] QWebEngineView::QWebEngineView(QWebEngineProfile *profile, QWidget *parent = nullptr)

Konstruiert eine leere Webansicht unter Verwendung von profile mit dem übergeordneten parent.

Diese Funktion wurde in Qt 6.4 eingeführt.

Siehe auch load().

[virtual noexcept] QWebEngineView::~QWebEngineView()

Zerstört die Webansicht.

[slot] void QWebEngineView::back()

Bequemer Slot, der das vorherige Dokument in der Liste der Dokumente lädt, die durch Navigationslinks erstellt wurde. Tut nichts, wenn es kein vorheriges Dokument gibt.

Er ist äquivalent zu:

    view->page()->triggerAction(QWebEnginePage::Back);

Siehe auch forward() und pageAction().

[override virtual protected] void QWebEngineView::closeEvent(QCloseEvent *event)

Reimplements: QWidget::closeEvent(QCloseEvent *event).

[override virtual protected] void QWebEngineView::contextMenuEvent(QContextMenuEvent *event)

Reimplements: QWidget::contextMenuEvent(QContextMenuEvent *event).

QMenu *QWebEngineView::createStandardContextMenu()

Erzeugt ein Standard-Kontextmenü und gibt einen Zeiger darauf zurück.

[virtual protected] QWebEngineView *QWebEngineView::createWindow(QWebEnginePage::WebWindowType type)

Diese Funktion wird von der Methode createWindow() des zugehörigen QWebEnginePage jedes Mal aufgerufen, wenn die Seite ein neues Fenster des angegebenen type erstellen möchte. Zum Beispiel, wenn eine JavaScript-Anforderung zum Öffnen eines Dokuments in einem neuen Fenster ausgegeben wird.

Siehe auch QWebEnginePage::createWindow().

[override virtual protected] void QWebEngineView::dragEnterEvent(QDragEnterEvent *e)

Reimplements: QWidget::dragEnterEvent(QDragEnterEvent *event).

[override virtual protected] void QWebEngineView::dragLeaveEvent(QDragLeaveEvent *e)

Reimplements: QWidget::dragLeaveEvent(QDragLeaveEvent *event).

[override virtual protected] void QWebEngineView::dragMoveEvent(QDragMoveEvent *e)

Reimplements: QWidget::dragMoveEvent(QDragMoveEvent *event).

[override virtual protected] void QWebEngineView::dropEvent(QDropEvent *e)

Reimplements: QWidget::dropEvent(QDropEvent *event).

[override virtual protected] bool QWebEngineView::event(QEvent *ev)

Reimplements: QWidget::event(QEvent *Event).

void QWebEngineView::findText(const QString &subString, QWebEnginePage::FindFlags options = {}, const std::function<void (const QWebEngineFindTextResult &)> &resultCallback = std::function<void(const QWebEngineFindTextResult &)>())

Findet die angegebene Zeichenkette subString in der Seite unter Verwendung der angegebenen options.

Um die Auswahl zu löschen, übergeben Sie einfach eine leere Zeichenfolge.

Der resultCallback muss einen QWebEngineFindTextResult Parameter enthalten.

Siehe auch selectedText() und selectionChanged().

[static, since 6.2] QWebEngineView *QWebEngineView::forPage(const QWebEnginePage *page)

Gibt die Ansicht zurück, die der page zugeordnet ist, falls vorhanden.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch page() und setPage().

[slot] void QWebEngineView::forward()

Bequemer Slot, der das nächste Dokument in der Liste der Dokumente lädt, die durch Navigationslinks erstellt wurden. Tut nichts, wenn es kein nächstes Dokument gibt.

Er ist äquivalent zu:

    view->page()->triggerAction(QWebEnginePage::Forward);

Siehe auch back() und pageAction().

[override virtual protected] void QWebEngineView::hideEvent(QHideEvent *event)

Reimplements: QWidget::hideEvent(QHideEvent *event).

QWebEngineHistory *QWebEngineView::history() const

Gibt einen Zeiger auf die Historie der navigierten Webseiten der Ansicht zurück.

Er ist äquivalent zu:

    view->page()->history();

[signal] void QWebEngineView::iconChanged(const QIcon &icon)

Dieses Signal wird ausgegeben, wenn das mit der Ansicht verbundene Symbol ("Favicon") geändert wird. Das neue Icon wird durch icon festgelegt.

Siehe auch icon(), iconUrl(), und iconUrlChanged().

[signal] void QWebEngineView::iconUrlChanged(const QUrl &url)

Dieses Signal wird ausgegeben, wenn die URL des mit der Ansicht verbundenen Symbols ("Favicon") geändert wird. Die neue URL wird durch url angegeben.

Siehe auch iconUrl(), icon(), und iconChanged().

[since 6.2] QWebEngineContextMenuRequest *QWebEngineView::lastContextMenuRequest() const

Gibt zusätzliche Daten über das aktuelle Kontextmenü zurück. Sie sind garantiert nur während des Aufrufs von contextMenuEvent() gültig.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch createStandardContextMenu().

void QWebEngineView::load(const QUrl &url)

Lädt die angegebene url und zeigt sie an.

Siehe auch load(), setUrl(), url(), urlChanged(), und QUrl::fromUserInput().

void QWebEngineView::load(const QWebEngineHttpRequest &request)

Stellt die angegebene request aus und lädt die Antwort.

Siehe auch load(), setUrl(), url(), urlChanged(), und QUrl::fromUserInput().

[signal] void QWebEngineView::loadFinished(bool ok)

Dieses Signal wird ausgegeben, wenn das Laden der Seite abgeschlossen ist. ok zeigt an, ob das Laden erfolgreich war oder ein Fehler aufgetreten ist.

Siehe auch loadStarted().

[signal] void QWebEngineView::loadProgress(int progress)

Dieses Signal wird jedes Mal ausgegeben, wenn ein Element in der Webansicht fertig geladen ist, z. B. ein eingebettetes Bild oder ein Skript. Es verfolgt also den kollektiven Fortschritt des Ladevorgangs der Webansicht.

Der aktuelle Wert wird von progress bereitgestellt und skaliert von 0 bis 100, was der Standardbereich von QProgressBar ist.

Siehe auch loadStarted() und loadFinished().

[signal] void QWebEngineView::loadStarted()

Dieses Signal wird ausgegeben, wenn ein neuer Ladevorgang der Seite gestartet wird.

Siehe auch loadProgress() und loadFinished().

QWebEnginePage *QWebEngineView::page() const

Gibt einen Zeiger auf die zugrunde liegende Webseite zurück.

Siehe auch setPage().

QAction *QWebEngineView::pageAction(QWebEnginePage::WebAction action) const

Gibt einen Zeiger auf ein QAction zurück, das die angegebene Webaktion action kapselt. Diese Funktion setzt auch ein Standard-Symbol auf QAction, wenn es keins gibt.

[signal, since 6.2] void QWebEngineView::pdfPrintingFinished(const QString &filePath, bool success)

Dieses Signal wird ausgegeben, wenn das Drucken der Webseite in eine PDF-Datei abgeschlossen ist. filePath enthält den Pfad, unter dem die Datei erstellt werden sollte, und success ist true, wenn die Datei erfolgreich erstellt wurde, und false, wenn nicht.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch printToPdf().

[since 6.2] void QWebEngineView::print(QPrinter *printer)

Rendert den aktuellen Inhalt der Seite in ein temporäres PDF-Dokument und druckt es dann mit printer.

Die Einstellungen für die Erstellung und den Druck des PDF-Dokuments werden aus dem Objekt printer abgerufen.

Nach Beendigung des Druckvorgangs wird das Signal printFinished() mit true für Erfolg oder false für Misserfolg ausgegeben.

Es liegt in der Verantwortung des Benutzers, sicherzustellen, dass printer gültig bleibt, bis printFinished() ausgegeben wurde.

Diese Funktion wurde in Qt 6.2 eingeführt.

[signal, since 6.2] void QWebEngineView::printFinished(bool success)

Dieses Signal wird ausgegeben, wenn der mit print() angeforderte Druck abgeschlossen ist. Der Parameter success ist true für Erfolg oder false für Misserfolg.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch print().

[signal, since 6.2] void QWebEngineView::printRequested()

Dieses Signal wird ausgegeben, wenn die JavaScript-Methode window.print() aufgerufen wird oder der Benutzer die Drucktaste des PDF-Viewer-Plugins gedrückt hat. Normalerweise kann der Signalhandler einfach print() aufrufen.

Seit 6.8 wird dieses Signal nur noch für den Hauptrahmen ausgegeben, anstatt für jeden Rahmen, der zum Drucken auffordert.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch printRequestedByFrame() und print().

[signal, since 6.8] void QWebEngineView::printRequestedByFrame(QWebEngineFrame frame)

Dieses Signal wird ausgegeben, wenn die JavaScript-Methode window.print() auf frame aufgerufen wird. Wenn es sich bei dem Frame um den Hauptrahmen handelt, wird stattdessen printRequested ausgegeben.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch printRequested() und print().

[since 6.2] void QWebEngineView::printToPdf(const QString &filePath, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Gibt den aktuellen Inhalt der Seite in ein PDF-Dokument wieder und speichert es an dem in filePath angegebenen Ort. Die Seitengröße und -ausrichtung des erzeugten PDF-Dokuments wird aus den in layout angegebenen Werten übernommen, während der Bereich der gedruckten Seiten aus ranges entnommen wird, wobei standardmäßig alle Seiten gedruckt werden.

Diese Methode stellt eine asynchrone Anforderung zum Drucken der Webseite in ein PDF-Dokument und kehrt sofort zurück. Um über das Ergebnis der Anforderung informiert zu werden, verbinden Sie sich mit dem Signal pdfPrintingFinished().

Existiert bereits eine Datei unter dem angegebenen Dateipfad, wird diese überschrieben.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch pdfPrintingFinished().

[since 6.2] void QWebEngineView::printToPdf(const std::function<void (const QByteArray &)> &resultCallback, const QPageLayout &layout = QPageLayout(QPageSize(QPageSize::A4), QPageLayout::Portrait, QMarginsF()), const QPageRanges &ranges = {})

Rendert den aktuellen Inhalt der Seite in ein PDF-Dokument und gibt ein Byte-Array mit den PDF-Daten als Parameter an resultCallback zurück. Die Seitengröße und die Ausrichtung des erzeugten PDF-Dokuments werden aus den in layout angegebenen Werten übernommen, während der Bereich der gedruckten Seiten aus ranges übernommen wird, wobei standardmäßig alle Seiten gedruckt werden.

resultCallback muss eine const-Referenz auf QByteArray als Parameter entgegennehmen. Wenn der Druck erfolgreich war, enthält dieses Byte-Array die PDF-Daten, andernfalls ist das Byte-Array leer.

Diese Funktion wurde in Qt 6.2 eingeführt.

[slot] void QWebEngineView::reload()

Lädt das aktuelle Dokument neu.

Siehe auch stop(), pageAction(), und loadStarted().

[signal] void QWebEngineView::renderProcessTerminated(QWebEnginePage::RenderProcessTerminationStatus terminationStatus, int exitCode)

Dieses Signal wird ausgegeben, wenn der Renderprozess mit einem Exit-Status ungleich Null beendet wird. terminationStatus ist der Beendigungsstatus des Prozesses und exitCode ist der Statuscode, mit dem der Prozess beendet wurde.

[signal] void QWebEngineView::selectionChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Auswahl ändert.

Siehe auch selectedText().

void QWebEngineView::setContent(const QByteArray &data, const QString &mimeType = QString(), const QUrl &baseUrl = QUrl())

Setzt den Inhalt der Webansicht auf data. Wenn das Argument mimeType leer ist, wird angenommen, dass der Inhalt text/plain,charset=US-ASCII ist.

Externe Objekte, auf die im Inhalt verwiesen wird, befinden sich relativ zu baseUrl. Damit externe Objekte mit relativen URLs geladen werden können, darf baseUrl nicht leer sein.

Die Daten werden sofort geladen; externe Objekte werden asynchron geladen.

Siehe auch load(), setHtml(), und QWebEnginePage::toHtml().

void QWebEngineView::setHtml(const QString &html, const QUrl &baseUrl = QUrl())

Setzt den Inhalt der Webansicht auf den angegebenen html Inhalt.

baseUrl ist optional und wird verwendet, um relative URLs im Dokument aufzulösen, wie referenzierte Bilder oder Stylesheets. Wenn beispielsweise html von http://www.example.com/documents/overview.html, der Basis-URL, abgerufen wird, dann sollte ein Bild, auf das mit der relativen URL diagram.png verwiesen wird, unter http://www.example.com/documents/diagram.png zu finden sein.

Das HTML-Dokument wird sofort geladen, während externe Objekte asynchron geladen werden.

Bei Verwendung dieser Methode geht Qt WebEngine davon aus, dass externe Ressourcen wie JavaScript-Programme oder Stylesheets in UTF-8 kodiert sind, sofern nicht anders angegeben. Die Kodierung eines externen Skripts kann zum Beispiel über das charset -Attribut des HTML-Skript-Tags angegeben werden. Alternativ kann die Kodierung auch durch den Webserver festgelegt werden.

Dies ist eine Komfortfunktion, die der Funktion setContent(html, "text/html;charset=UTF-8", baseUrl) entspricht.

Siehe auch load(), setContent(), QWebEnginePage::toHtml(), und QWebEnginePage::setContent().

void QWebEngineView::setPage(QWebEnginePage *page)

Macht page zur neuen Web-Seite der Web-Ansicht.

Die übergeordnete Seite QObject der bereitgestellten Seite bleibt der Eigentümer des Objekts. Wenn die aktuelle Seite ein Kind der Webansicht ist, wird sie gelöscht.

Siehe auch page().

QWebEngineSettings *QWebEngineView::settings() const

Gibt einen Zeiger auf das View- oder Page-spezifische Settings-Objekt zurück.

Es ist äquivalent zu:

    view->page()->settings();

[override virtual protected] void QWebEngineView::showEvent(QShowEvent *event)

Reimplements: QWidget::showEvent(QShowEvent *event).

[override virtual] QSize QWebEngineView::sizeHint() const

Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.

[slot] void QWebEngineView::stop()

Bequemer Slot, der das Laden des Dokuments stoppt.

Er ist äquivalent zu:

    view->page()->triggerAction(QWebEnginePage::Stop);

Siehe auch reload(), pageAction(), und loadFinished().

[signal] void QWebEngineView::titleChanged(const QString &title)

Dieses Signal wird ausgegeben, wenn sich die title der Ansicht ändert.

Siehe auch title().

void QWebEngineView::triggerPageAction(QWebEnginePage::WebAction action, bool checked = false)

Löst die angegebene action aus. Handelt es sich um eine überprüfbare Aktion, wird der angegebene checked Zustand angenommen.

Das folgende Beispiel löst die Aktion "Kopieren" aus und kopiert daher den ausgewählten Text in die Zwischenablage.

    view->triggerPageAction(QWebEnginePage::Copy);

Siehe auch pageAction().

[signal] void QWebEngineView::urlChanged(const QUrl &url)

Dieses Signal wird ausgegeben, wenn sich die url der Ansicht ändert.

Siehe auch url() und load().