QWebEnginePage Class

Dokumentation der Mitgliedsfunktionen

Führt den in scriptSource enthaltenen JavaScript-Code aus, ohne zu prüfen, ob das DOM der Seite bereits aufgebaut wurde. Wenn Sie mehr Kontrolle darüber benötigen, wie das Skript ausgeführt wird, sollten Sie stattdessen scripts() verwenden.

Um Konflikte mit anderen auf der Seite ausgeführten Skripts zu vermeiden, wird die Welt, in der das Skript ausgeführt wird, mit worldId angegeben. Die Welt-ID-Werte entsprechen denen von QWebEngineScript::ScriptWorldId und liegen zwischen 0 und 256. Wenn Sie die ID world weglassen, wird das Skript in der Welt MainWorld ausgeführt.

Wenn das Skript ausgeführt wurde, wird resultCallback mit dem Ergebnis der zuletzt ausgeführten Anweisung aufgerufen. resultCallback kann ein Funktionszeiger, ein Funktor oder ein Lambda sein und muss einen Parameter QVariant enthalten. Ein Beispiel:

page.runJavaScript("document.title", [](const QVariant &v) { qDebug() << v.toString(); });

Nur einfache Daten können von JavaScript als Ergebniswert zurückgegeben werden. Zu den unterstützten Datentypen gehören alle JSON-Datentypen sowie z. B. Date und ArrayBuffer. Nicht unterstützte Datentypen sind z. B. Function und Promise.

Siehe auch scripts(), QWebEngineScript::ScriptWorldId, QWebEngineFrame::runJavaScript, und Script Injection.

[explicit] QWebEnginePage::QWebEnginePage(QObject *parent = nullptr)

Konstruiert eine leere QWebEnginePage mit dem übergeordneten parent.

QWebEnginePage::QWebEnginePage(QWebEngineProfile *profile, QObject *parent = nullptr)

Konstruiert eine leere Web-Engine-Seite im Web-Engine-Profil profile mit dem übergeordneten parent.

Handelt es sich bei dem Profil nicht um das Standardprofil, muss der Aufrufer sicherstellen, dass das Profil so lange aktiv bleibt, wie die Seite besteht.

[virtual noexcept] QWebEnginePage::~QWebEnginePage()

Zerstört die Webseite.

[virtual protected] bool QWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)

Diese Funktion wird aufgerufen, wenn eine Anfrage zur Navigation zum angegebenen url mit Hilfe des angegebenen Navigationstyps type eingeht. isMainFrame gibt an, ob sich die Anfrage auf den Hauptrahmen oder einen untergeordneten Rahmen bezieht. Wenn die Funktion true zurückgibt, wird die Navigationsanforderung akzeptiert und url geladen. Die Standardimplementierung akzeptiert alle Navigationsanfragen.

Navigationsanfragen können an die Qt-Anwendung delegiert werden, anstatt sie von der HTML-Handler-Engine verarbeiten zu lassen, indem diese Funktion überladen wird. Dies ist notwendig, wenn ein HTML-Dokument als Teil der Benutzeroberfläche verwendet wird und nicht um externe Daten anzuzeigen, zum Beispiel bei der Anzeige einer Ergebnisliste.

Die Klasse QWebEngineUrlRequestInterceptor bietet weitere Optionen zum Abfangen und Manipulieren von Anfragen.

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

Gibt eine QAction für die angegebene WebAction action zurück.

Die Aktion ist Eigentum von QWebEnginePage, aber Sie können das Aussehen anpassen, indem Sie die Eigenschaften ändern.

Die zurückgegebene Aktion hat kein standardmäßig gestyltes Symbol. Verwenden Sie QWebEngineView::pageAction(), um eine Aktion mit einem standardmäßig gestylten Symbol zu erhalten.

QWebEnginePage kümmert sich auch um die Implementierung der Aktion, so dass beim Auslösen die entsprechende Aktion auf der Seite ausgeführt wird.

Siehe auch triggerAction().

[signal] void QWebEnginePage::audioMutedChanged(bool muted)

Dieses Signal wird ausgesendet, wenn sich der Zustand der Seite muted ändert.

[signal] void QWebEnginePage::authenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator)

Dieses Signal wird ausgegeben, wenn der Zugriff auf requestUrl eine Authentifizierung erfordert. authenticator sollte verwendet werden, um den Benutzernamen und das Passwort für die Verbindung zu übergeben.

[signal] void QWebEnginePage::certificateError(const QWebEngineCertificateError &certificateError)

Dieses Signal wird ausgegeben, wenn beim Laden einer bestimmten Anforderung ein Fehler durch ein ungültiges Zertifikat auftritt.

Der Parameter certificateError enthält Informationen über das Zertifikat und Details über den Fehler. Er bietet auch die Möglichkeit, den Fehler zu ignorieren und die Anfrage abzuschließen oder das Laden der Anfrage zu beenden.

Siehe auch QWebEngineCertificateError.

[virtual protected] QStringList QWebEnginePage::chooseFiles(QWebEnginePage::FileSelectionMode mode, const QStringList &oldFiles, const QStringList &acceptedMimeTypes)

Diese Funktion wird aufgerufen, wenn der Webinhalt einen Dateinamen anfordert, z. B. wenn der Benutzer auf eine Schaltfläche zum Hochladen einer Datei in einem HTML-Formular klickt.

mode gibt an, ob nur eine Datei oder mehrere Dateien zurückgegeben werden sollen.

Ein vorgeschlagener Dateiname kann als erster Eintrag von oldFiles angegeben werden. acceptedMimeTypes wird von der Standardimplementierung ignoriert, kann aber von Überschreibungen verwendet werden.

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

Diese Funktion wird aufgerufen, um ein neues Fenster mit dem angegebenen type zu erstellen. Zum Beispiel, wenn ein JavaScript-Programm anfordert, ein Dokument in einem neuen Fenster zu öffnen.

Wenn das neue Fenster erstellt werden kann, wird QWebEnginePage zurückgegeben; andernfalls wird ein Null-Zeiger zurückgegeben.

Wenn die mit der Webseite verbundene Ansicht ein QWebEngineView -Objekt ist, leitet die Standardimplementierung die Anforderung an QWebEngineView::createWindow() weiter; andernfalls wird ein Null-Zeiger zurückgegeben.

Wenn dieser Aufruf nicht implementiert ist oder keine neue Seite zurückgibt, wird newWindowRequested() ausgegeben, um die Anfrage zu bearbeiten.

Siehe auch QWebEngineView::createWindow() und newWindowRequested().

[signal, since 6.7] void QWebEnginePage::desktopMediaRequested(const QWebEngineDesktopMediaRequest &request)

Dieses Signal wird ausgegeben, wenn eine Webanwendung den Zugriff auf den Inhalt eines Bildschirms anfordert.

Das Argument request enthält Verweise auf Datenmodelle für Fenster und Bildschirme, die für die Erfassung verfügbar sind. Um die Anforderung anzunehmen, kann der Signalhandler entweder QWebEngineDesktopMediaRequest::selectScreen() oder QWebEngineDesktopMediaRequest::selectWindow() aufrufen.

Diese Funktion wurde in Qt 6.7 eingeführt.

[since 6.6] QString QWebEnginePage::devToolsId() const

Gibt die ID des mit dieser Seite verbundenen Entwicklertools-Hosts zurück.

Wenn Remote-Debugging aktiviert ist (siehe Qt WebEngine Entwicklertools), kann die ID verwendet werden, um die URL für die Verbindung mit dem Websocket des Entwicklertools zu erstellen: ws://localhost:<debugggin-port>/devtools/page/<id>). Der Websocket kann verwendet werden, um mit der Seite unter Verwendung des DevTools-Protokolls zu interagieren.

Diese Funktion wurde in Qt 6.6 eingeführt.

QWebEnginePage *QWebEnginePage::devToolsPage() const

Gibt die Seite zurück, auf der die Entwicklertools dieser Seite gehostet werden, falls vorhanden.

Gibt nullptr zurück, wenn keine Seite für Entwicklerwerkzeuge festgelegt ist.

Siehe auch setDevToolsPage() und inspectedPage().

void QWebEnginePage::download(const QUrl &url, const QString &filename = QString())

Lädt die Ressource von dem durch url angegebenen Ort in eine lokale Datei herunter.

Wenn filename angegeben wird, wird dies als vorgeschlagener Dateiname verwendet. Wenn er relativ ist, wird die Datei am Standard-Download-Speicherort unter dem angegebenen Namen gespeichert. Wenn es sich um eine Null oder einen leeren QString handelt, wird der Standarddateiname verwendet.

Nach dem Start des Downloads wird die Meldung QWebEngineProfile::downloadRequested() ausgegeben.

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

Reimplements: QObject::event(QEvent *e).

[signal, since 6.4] void QWebEnginePage::fileSystemAccessRequested(QWebEngineFileSystemAccessRequest request)

Dieses Signal wird ausgegeben, wenn die Webseite den Zugriff auf lokale Dateien oder Verzeichnisse anfordert.

Das Request-Objekt request kann verwendet werden, um die Anfrage anzunehmen oder abzulehnen.

Diese Funktion wurde in Qt 6.4 eingeführt.

[since 6.8] std::optional<QWebEngineFrame> QWebEnginePage::findFrameByName(QAnyStringView name)

Gibt den Rahmen mit dem angegebenen name zurück. Wenn es mehrere Frames mit demselben Namen gibt, ist es beliebig, welcher zurückgegeben wird. Wurde kein Frame gefunden, wird std::nullopt zurückgegeben.

Diese Funktion wurde in Qt 6.8 eingeführt.

void QWebEnginePage::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. Das Signal findTextFinished() wird ausgegeben, wenn eine Zeichenkettensuche abgeschlossen ist.

Um die Suchmarkierung zu löschen, übergeben Sie einfach eine leere Zeichenkette.

Der resultCallback muss einen QWebEngineFindTextResult Parameter enthalten.

Zum Beispiel:

    m_view->page()->findText(QStringLiteral("Qt"), QWebEnginePage::FindFlags(), [this](const QWebEngineFindTextResult &result) {
        if (result.numberOfMatches() == 0) QMessageBox::information(m_view, QString(), QStringLiteral("No occurrences found"));
    });

Siehe auch findTextFinished().

[signal] void QWebEnginePage::findTextFinished(const QWebEngineFindTextResult &result)

Dieses Signal wird ausgegeben, wenn eine Suchstringsuche auf einer Seite abgeschlossen ist. result ist das Ergebnis der Stringsuche.

Siehe auch findText().

[signal] void QWebEnginePage::fullScreenRequested(QWebEngineFullScreenRequest fullScreenRequest)

Dieses Signal wird ausgesendet, wenn die Webseite die Anforderung stellt, den Vollbildmodus für ein Web-Element, in der Regel ein Video-Element, zu aktivieren.

Das Request-Objekt fullScreenRequest kann verwendet werden, um die Anfrage zu akzeptieren oder abzulehnen.

Wenn die Anforderung akzeptiert wird, füllt das Element, das den Vollbildmodus anfordert, das Ansichtsfenster aus, aber es liegt an der Anwendung, die Ansicht in den Vollbildmodus zu bringen oder die Seite in eine Ansicht zu verschieben, die den Vollbildmodus hat.

Siehe auch QWebEngineSettings::FullScreenSupportEnabled.

[signal] void QWebEnginePage::geometryChangeRequested(const QRect &geom)

Dieses Signal wird immer dann ausgegeben, wenn das Dokument die Position und Größe der Seite geom ändern möchte. Dies kann z. B. durch JavaScript geschehen.

window->setGeometry(geom.marginsRemoved(window->frameMargins()));

QWebEngineHistory *QWebEnginePage::history() const

Gibt einen Zeiger auf den Verlauf der navigierten Webseiten der Ansicht zurück.

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

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

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

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

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

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

QWebEnginePage *QWebEnginePage::inspectedPage() const

Gibt die Seite zurück, die diese Seite inspiziert, falls vorhanden.

Gibt nullptr zurück, wenn diese Seite keine Seite für Entwicklerwerkzeuge ist.

Siehe auch setInspectedPage() und devToolsPage().

[virtual protected] void QWebEnginePage::javaScriptAlert(const QUrl &securityOrigin, const QString &msg)

Diese Funktion wird immer dann aufgerufen, wenn ein JavaScript-Programm, das in einem Frame läuft, der mit securityOrigin verbunden ist, die Funktion alert() mit der Nachricht msg aufruft.

In der Standardimplementierung wird die Nachricht msg mit QMessageBox::information angezeigt.

[virtual protected] bool QWebEnginePage::javaScriptConfirm(const QUrl &securityOrigin, const QString &msg)

Diese Funktion wird immer dann aufgerufen, wenn ein JavaScript-Programm, das in einem Frame läuft, der mit securityOrigin verbunden ist, die Funktion confirm() mit der Nachricht msg aufruft. Gibt true zurück, wenn der Benutzer die Nachricht bestätigt; andernfalls gibt sie false zurück.

Sie wird auch aufgerufen, wenn der onbeforeunload -Handler eine Bestätigung anfordert, bevor er eine Seite verlässt.

Bei der Standardimplementierung wird die Abfrage über QMessageBox::information mit den Schaltflächen QMessageBox::Ok und QMessageBox::Cancel ausgeführt.

[virtual protected] void QWebEnginePage::javaScriptConsoleMessage(QWebEnginePage::JavaScriptConsoleMessageLevel level, const QString &message, int lineNumber, const QString &sourceID)

Diese Funktion wird aufgerufen, wenn ein JavaScript-Programm versucht, die message auf der Konsole des Webbrowsers auszugeben.

Bei Auswertungsfehlern kann z. B. die Quell-URL in sourceID sowie die lineNumber angegeben werden.

level gibt den Schweregrad des Ereignisses an, das die Meldung ausgelöst hat. Das heißt, ob sie durch einen Fehler oder ein weniger schwerwiegendes Ereignis ausgelöst wurde.

Seit Qt 5.6 protokolliert die Standardimplementierung die Meldungen in einem js logging category .

Siehe auch Konsolenprotokollierung.

[virtual protected] bool QWebEnginePage::javaScriptPrompt(const QUrl &securityOrigin, const QString &msg, const QString &defaultValue, QString *result)

Diese Funktion wird immer dann aufgerufen, wenn ein JavaScript-Programm, das in einem mit securityOrigin verknüpften Frame läuft, versucht, den Benutzer zur Eingabe aufzufordern. Das Programm kann eine optionale Nachricht, msg, sowie einen Standardwert für die Eingabe in defaultValue angeben.

Wurde die Eingabeaufforderung vom Benutzer abgebrochen, sollte die Implementierung false zurückgeben; andernfalls sollte das Ergebnis in result geschrieben und true zurückgegeben werden. Wurde die Eingabeaufforderung nicht vom Benutzer abgebrochen, sollte die Implementierung true zurückgeben, und die Ergebniszeichenfolge darf nicht null sein.

Die Standardimplementierung verwendet QInputDialog::getText().

[signal] void QWebEnginePage::linkHovered(const QString &url)

Dieses Signal wird ausgegeben, wenn die Maus über einem Link schwebt. url enthält die Ziel-URL des Links.

void QWebEnginePage::load(const QUrl &url)

Lädt url in diese Seite.

Siehe auch setUrl(), setHtml(), und setContent().

void QWebEnginePage::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 QWebEnginePage::loadFinished(bool ok)

Dieses Signal wird ausgegeben, wenn die Seite das Laden des Inhalts beendet hat. Dieses Signal ist unabhängig von der Skriptausführung oder dem Rendering der Seite. ok zeigt an, ob das Laden erfolgreich war oder ein Fehler aufgetreten ist.

Siehe auch loadStarted() und acceptNavigationRequest().

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

Dieses Signal wird ausgesendet, wenn sich der globale Fortschrittsstatus ändert. Der aktuelle Wert wird von progress geliefert und reicht von 0 bis 100, was dem Standardbereich von QProgressBar entspricht. Es akkumuliert die Änderungen aller Child-Frames.

[signal] void QWebEnginePage::loadStarted()

Dieses Signal wird ausgegeben, wenn eine Seite mit dem Laden von Inhalten beginnt.

Siehe auch loadFinished() und acceptNavigationRequest().

[signal, since 6.2] void QWebEnginePage::loadingChanged(const QWebEngineLoadingInfo &loadingInfo)

Dieses Signal wird ausgegeben, wenn das Laden der durch loadingInfo angegebenen Seite beginnt, endet oder fehlschlägt.

Diese Funktion wurde in Qt 6.2 eingeführt.

[since 6.8] QWebEngineFrame QWebEnginePage::mainFrame()

Der Hauptrahmen auf der obersten Ebene der Seite. Alle anderen Rahmen auf dieser Seite sind als untergeordnete Rahmen des Hauptrahmens zugänglich.

Diese Funktion wurde in Qt 6.8 eingeführt.

[signal, since 6.2] void QWebEnginePage::navigationRequested(QWebEngineNavigationRequest &request)

Dieses Signal wird bei der Navigation zusammen mit dem Aufruf von acceptNavigationRequest() ausgegeben. Es kann verwendet werden, um die request zu akzeptieren oder zu ignorieren. Die Voreinstellung ist zu akzeptieren.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch acceptNavigationRequest().

[signal, since 6.2] void QWebEnginePage::newWindowRequested(QWebEngineNewWindowRequest &request)

Dieses Signal wird ausgegeben, wenn request zum Laden einer Seite in einem separaten Fenster der Web-Engine aufgerufen wird. Dies kann entweder sein, weil die aktuelle Seite dies explizit durch einen JavaScript-Aufruf an window.open angefordert hat, oder weil der Benutzer auf einen Link geklickt hat, während er die Umschalttaste, die Strg-Taste oder eine integrierte Kombination gedrückt hielt, die das Öffnen der Seite in einem neuen Fenster auslöst.

Das Signal wird durch den Aufruf von openIn() mit der neuen Seite bei der Anfrage behandelt. Wenn dieses Signal nicht behandelt wird, schlägt das angeforderte Laden fehl.

Diese Funktion wurde in Qt 6.2 eingeführt.

Siehe auch createWindow() und QWebEngineNewWindowRequest::openIn().

[signal] void QWebEnginePage::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 andernfalls false.

Siehe auch printToPdf().

[signal, since 6.8] void QWebEnginePage::permissionRequested(QWebEnginePermission permission)

Dieses Signal wird ausgegeben, wenn eine Website um die Nutzung einer Funktion bittet (z. B. Zugang zur Geolokalisierung, Erlaubnis zum Senden von Benachrichtigungen). Das permission Objekt kann nach der anfragenden URL und der QWebEnginePermission::Feature abgefragt werden, sowie die Erlaubnis erteilen oder verweigern.

Diese Funktion wurde in Qt 6.8 eingeführt.

[signal] void QWebEnginePage::printRequested()

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

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

Siehe auch printToPdf() und printRequestedByFrame().

[signal, since 6.8] void QWebEnginePage::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(), printToPdf(), und QWebEngineFrame::printToPdf().

void QWebEnginePage::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 sie überschrieben.

Siehe auch pdfPrintingFinished().

void QWebEnginePage::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.

QWebEngineProfile *QWebEnginePage::profile() const

Gibt das Profil der Web-Engine zurück, zu der die Seite gehört.

[signal] void QWebEnginePage::proxyAuthenticationRequired(const QUrl &requestUrl, QAuthenticator *authenticator, const QString &proxyHost)

Dieses Signal wird ausgegeben, wenn der Zugriff auf requestUrl über proxyHost eine Authentifizierung für den Proxy erfordert. authenticator sollte verwendet werden, um den Benutzernamen und das Passwort für die Verbindung zu übergeben.

[signal] void QWebEnginePage::recentlyAudibleChanged(bool recentlyAudible)

Dieses Signal wird ausgegeben, wenn sich der akustische Zustand der Seite recentlyAudible ändert, weil der Ton abgespielt oder angehalten wird.

[signal] void QWebEnginePage::registerProtocolHandlerRequested(QWebEngineRegisterProtocolHandlerRequest request)

Dieses Signal wird ausgegeben, wenn die Webseite versucht, ein benutzerdefiniertes Protokoll mithilfe der registerProtocolHandler-API zu registrieren.

Das Anfrageobjekt request kann verwendet werden, um die Anfrage anzunehmen oder abzulehnen:

void WebView::handleRegisterProtocolHandlerRequested(
        QWebEngineRegisterProtocolHandlerRequest request)
{
    auto answer = QMessageBox::question(window(), tr("Permission Request"),
                                        tr("Allow %1 to open all %2 links?")
                                                .arg(request.origin().host())
                                                .arg(request.scheme()));
    if (answer == QMessageBox::Yes)
        request.accept();
    else
        request.reject();
}

[signal] void QWebEnginePage::renderProcessPidChanged(qint64 pid)

Dieses Signal wird ausgegeben, wenn sich die PID des zugrundeliegenden Renderprozesses, pid, ändert.

[signal] void QWebEnginePage::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.

void QWebEnginePage::replaceMisspelledWord(const QString &replacement)

Ersetzen Sie das aktuell falsch geschriebene Wort durch replacement.

Das aktuell falsch geschriebene Wort finden Sie unter QWebEngineContextMenuRequest::misspelledWord(), die vorgeschlagenen Ersetzungen unter QWebEngineContextMenuRequest::spellCheckerSuggestions().

void QWebEnginePage::save(const QString &filePath, QWebEngineDownloadRequest::SavePageFormat format = QWebEngineDownloadRequest::MimeHtmlSaveFormat) const

Speichern Sie die aktuell geladene Webseite auf der Festplatte.

Die Webseite wird auf filePath unter der angegebenen Adresse format gespeichert.

Dies ist eine Abkürzung für die folgenden Aktionen:

• Auslösen der Aktion Web speichern.
• Akzeptieren Sie das nächste Download-Element und legen Sie den angegebenen Dateipfad und das Speicherformat fest.

Diese Funktion stellt eine asynchrone Download-Anforderung für die Webseite und kehrt sofort zurück.

Siehe auch QWebEngineDownloadRequest::SavePageFormat.

QWebEngineScriptCollection &QWebEnginePage::scripts()

Gibt die Sammlung von Skripten zurück, die in die Seite eingefügt werden.

Darüber hinaus kann eine Seite auch Skripte ausführen, die über QWebEngineProfile::scripts() hinzugefügt wurden.

Siehe auch QWebEngineScriptCollection, QWebEngineScript, und Script Injection.

[signal] void QWebEnginePage::selectClientCertificate(QWebEngineClientCertificateSelection clientCertificateSelection)

Dieses Signal wird ausgegeben, wenn eine Website ein SSL-Client-Zertifikat anfordert und ein oder mehrere im Client-Zertifikatspeicher des Systems gefunden wurden.

Die Verarbeitung des Signals erfolgt asynchron, und das Laden wartet, bis ein Zertifikat ausgewählt oder die letzte Kopie von clientCertificateSelection zerstört wird.

Wenn das Signal nicht behandelt wird, wird clientCertificateSelection automatisch zerstört und das Laden wird ohne Client-Zertifikat fortgesetzt.

Siehe auch QWebEngineClientCertificateSelection.

[signal] void QWebEnginePage::selectionChanged()

Dieses Signal wird immer dann ausgegeben, wenn sich die Auswahl ändert, entweder interaktiv oder programmatisch. Zum Beispiel durch den Aufruf von triggerAction() mit einer Auswahlaktion.

Siehe auch selectedText().

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

Setzt den Inhalt der Webseite 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 data wird sofort geladen; externe Objekte werden asynchron geladen.

Siehe auch toHtml() und setHtml().

void QWebEnginePage::setDevToolsPage(QWebEnginePage *devToolsPage)

Bindet devToolsPage an die Entwicklertools dieser Seite. Löst devToolsPage aus, um zu einer internen URL mit den Entwicklertools zu navigieren.

Dies ist dasselbe wie der Aufruf von setInspectedPage() auf devToolsPage mit this als Argument.

Siehe auch devToolsPage() und setInspectedPage().

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

Setzt den Inhalt dieser Seite auf html. baseUrl ist optional und wird verwendet, um relative URLs im Dokument aufzulösen, z. B. referenzierte Bilder oder Stylesheets.

Die html wird sofort geladen; externe Objekte werden asynchron geladen.

Läuft ein Skript in html länger als der Standard-Timeout für Skripte (derzeit 10 Sekunden), z. B. weil es durch einen modalen JavaScript-Warndialog blockiert wird, kehrt diese Methode so schnell wie möglich nach dem Timeout zurück, und alle nachfolgenden html werden asynchron geladen.

Bei Verwendung dieser Methode geht die Web-Engine davon aus, dass externe Ressourcen wie JavaScript-Programme oder Stylesheets in UTF-8 kodiert sind, sofern nichts anderes angegeben ist. Die Kodierung eines externen Skripts kann zum Beispiel über das charset-Attribut des HTML-Skript-Tags angegeben werden. Es ist auch möglich, dass die Kodierung durch den Webserver festgelegt wird.

Dies ist eine Komfortfunktion, die setContent(html, "text/html", baseUrl) entspricht.

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

void QWebEnginePage::setInspectedPage(QWebEnginePage *page)

Navigiert diese Seite zu einer internen URL, bei der es sich um die Entwicklerwerkzeuge von page handelt.

Dies ist dasselbe wie der Aufruf von setDevToolsPage() auf page mit this als Argument.

Siehe auch inspectedPage() und setDevToolsPage().

void QWebEnginePage::setUrlRequestInterceptor(QWebEngineUrlRequestInterceptor *interceptor)

Registriert den Request Interceptor interceptor, um URL-Anfragen abzufangen.

Die Seite ist nicht Eigentümer des Zeigers. Dieser Abfangdienst wird nach allen Abfangdiensten des Profils aufgerufen, und im Gegensatz zu Profilabfangdiensten werden nur URL-Anfragen von dieser Seite abgefangen. Wenn die ursprüngliche Anfrage bereits durch den Profilabfangdienst blockiert oder umgeleitet wurde, wird sie durch diesen nicht abgefangen.

Um den Request Interceptor zu deaktivieren, setzen Sie ein nullptr.

Siehe auch QWebEngineUrlRequestInfo und QWebEngineProfile::setUrlRequestInterceptor().

void QWebEnginePage::setWebChannel(QWebChannel *channel, quint32 worldId = 0)

Setzt die Web-Channel-Instanz, die von dieser Seite verwendet werden soll, auf channel und verbindet sie mit dem Transport der Web-Engine über Chromium-IPC-Nachrichten. Der Transport ist in der JavaScript-Welt worldId als qt.webChannelTransport offengelegt, was bei Verwendung der Qt WebChannel JavaScript-API verwendet werden sollte.

Siehe auch webChannel() und QWebEngineScript::ScriptWorldId.

QWebEngineSettings *QWebEnginePage::settings() const

Gibt einen Zeiger auf das Einstellungsobjekt der Seite zurück.

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

Dieses Signal wird ausgegeben, wenn sich der Titel der Seite ändert. Die Zeichenkette title gibt den neuen Titel an.

Siehe auch title().

void QWebEnginePage::toHtml(const std::function<void (const QString &)> &resultCallback) const

Asynchrone Methode zum Abrufen des Seiteninhalts als HTML, eingeschlossen in HTML- und BODY-Tags. Nach erfolgreichem Abschluss wird resultCallback mit dem Inhalt der Seite aufgerufen.

Siehe auch setHtml() und toPlainText().

void QWebEnginePage::toPlainText(const std::function<void (const QString &)> &resultCallback) const

Asynchrone Methode zum Abrufen des in reinen Text umgewandelten Seiteninhalts, der vollständig von allen HTML-Formatierungen befreit ist. Nach erfolgreichem Abschluss wird resultCallback mit dem Inhalt der Seite aufgerufen.

Siehe auch toHtml().

[virtual] void QWebEnginePage::triggerAction(QWebEnginePage::WebAction action, bool checked = false)

Diese Funktion kann aufgerufen werden, um die angegebene action auszulösen. Sie wird auch von Qt WebEngine aufgerufen, wenn der Benutzer die Aktion auslöst, z. B. durch einen Kontextmenüeintrag.

Wenn action eine überprüfbare Aktion ist, dann gibt checked an, ob die Aktion umgeschaltet wird oder nicht.

Siehe auch action().

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

Dieses Signal wird mit der URL der Seite ausgegeben, wenn der Seitentitel empfangen wird. Die neue URL wird durch url angegeben.

Siehe auch url().

[signal, since 6.7] void QWebEnginePage::webAuthUxRequested(QWebEngineWebAuthUxRequest *request)

Dieses Signal wird ausgegeben, wenn ein WebAuth-Authentifikator eine Benutzerinteraktion während des Authentifizierungsprozesses benötigt. Diese Anfragen werden behandelt, indem dem Benutzer ein Dialog angezeigt wird.

Die request enthält die Informationen und die API, die erforderlich sind, um die WebAuth UX-Anfrage abzuschließen.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QWebEngineWebAuthUxRequest.

QWebChannel *QWebEnginePage::webChannel() const

Gibt einen Zeiger auf die Webkanalinstanz zurück, die von dieser Seite verwendet wird, oder einen Null-Zeiger, wenn keiner gesetzt wurde. Dieser Kanal verwendet automatisch den internen Web-Engine-Transportmechanismus über Chromium IPC, der im JavaScript-Kontext dieser Seite als qt.webChannelTransport verfügbar ist.

Siehe auch setWebChannel().

[signal] void QWebEnginePage::windowCloseRequested()

Dieses Signal wird ausgegeben, wenn die Seite das Schließen des Webbrowser-Fensters anfordert, z. B. durch den JavaScript-Aufruf window.close().

Siehe auch RequestClose.

[signal, since 6.8] void QWebEnginePage::zoomFactorChanged(qreal factor)

Dieses Signal wird ausgegeben, wenn sich der Zoom factor für die Seite ändert.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch zoomFactor() und setZoomFactor().