WebEngineView QML Type

Beschreibt verschiedene hochrangige Fehlertypen:

Beschreibt die verfügbaren Optionen für die Funktion findText(). Die Optionen können aus der folgenden Liste miteinander ODER-verknüpft werden:

Siehe auch findText().

Gibt den Schweregrad einer JavaScript-Konsolenmeldung an:

Diese Aufzählung beschreibt den Lebenszyklusstatus der Seite:

Diese Eigenschaft wurde in QtWebEngine 1.10 eingeführt.

Siehe auch lifecycleState, Page Lifecycle API, und WebEngine Lifecycle Example.

Spiegelt den Ladestatus einer Seite wider:

Beschreibt die Ausrichtung eines PDF-Dokuments, das aus dem Inhalt von WebEngineView erstellt wird. Die Aufzählungswerte werden von QPageLayout::Orientation übernommen und müssen mit diesem übereinstimmen.

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Siehe auch WebEngineView::printToPdf().

Dieser Enum-Typ listet die verfügbaren Seitengrößen auf, wie sie im Postscript PPD Standard definiert sind.

Die Aufzählungswerte werden von QPageSize::PageSizeId übernommen und müssen mit diesen übereinstimmen. Sie werden auch in QPagedPaintDevice und QPrinter dupliziert.

Die definierten Größen sind:

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Siehe auch WebEngineView::printToPdf().

Beschreibt den Status, mit dem der Renderprozess abgebrochen wurde:

Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.

Beschreibt die Arten von Aktionen, die auf einer Webseite durchgeführt werden können:

Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.

Gibt an, ob die Ansicht den aktiven Fokus erhalten soll, wenn sie gedrückt wird. Der Standardwert ist true.

Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.

Der Zustand, ob das Audio der aktuellen Seite stummgeschaltet ist.

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Siehe auch recentlyAudible.

Ändert die Farbe des Hintergrunds von WebEngineView hinter dem Textkörper des Dokuments. Kann auf "transparent" oder auf eine durchscheinende Farbe gesetzt werden, um durch das Dokument hindurchzusehen oder um den Webinhalt in einer hybriden Anwendung anzupassen, um die weißen Blitze zu verhindern, die während des Ladens auftreten können.

Der Standardwert ist weiß.

Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.

Gibt true zurück, wenn es frühere Einträge im Sitzungsverlauf gibt, andernfalls false.

Gibt true zurück, wenn es nachfolgende Einträge im Sitzungsverlauf gibt, andernfalls false.

Größe des Seiteninhalts.

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Die ID des Entwicklertools-Hosts, der mit dieser Seite verbunden ist.

Wenn Remote-Debugging aktiviert ist (siehe Qt WebEngine Developer Tools), kann die ID verwendet werden, um die URL für die Verbindung zum Websocket des Entwickler-Tools 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 Eigenschaft wurde in QtWebEngine 6.6 eingeführt.

Die Ansicht, die derzeit die Entwicklertools für diese Ansicht enthält. Wird sie auf eine neue Ansicht gesetzt, navigiert diese zu einer internen URL mit den Entwicklerwerkzeugen und bindet sie an diese Ansicht.

Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.

Siehe auch inspectedView.

Die Navigationshistorie der aktuellen Ansicht.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

Siehe auch WebEngineHistory.

Eine interne URL für den Zugriff auf das aktuell angezeigte Webseitensymbol, auch bekannt als Favicon oder Shortcut-Icon. Diese schreibgeschützte URL entspricht dem Bild, das in einer mobilen Browseranwendung verwendet wird, um eine mit einem Lesezeichen versehene Seite auf dem Startbildschirm des Geräts darzustellen.

Das folgende Snippet verwendet die Eigenschaft icon, um eine Komponente Image zu erstellen:

Image {
    id: appIcon
    sourceSize: Qt.size(32, 32)
    source: webView.icon != "" ? webView.icon : "fallbackFavicon.png";
    // ...
}

Die Angabe der Eigenschaft Image::sourceSize informiert den Favicon-Anbieter Qt WebEngine über die angeforderte Größe und passt die Größe des Symbols an diese an. Wenn die Image::sourceSize Eigenschaft nicht angegeben wird, stellt der Anbieter das Symbol mit der größten verfügbaren Auflösung bereit.

Die Ansicht, die diese Ansicht gerade inspiziert, falls vorhanden. Wenn diese Eigenschaft gesetzt ist, wird zu einer internen URL mit den Entwickler-Tools der eingestellten Ansicht navigiert.

Es wird empfohlen, diese Eigenschaft zu deaktivieren, wenn die Entwicklerwerkzeuge nicht sichtbar sind; andernfalls könnten einige Debug-Informationen in der inspizierten WebEngineView erscheinen.

Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.

Siehe auch devToolsView.

Gibt true zurück, wenn sich die Webansicht im Vollbildmodus befindet, andernfalls false.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

Siehe auch fullScreenRequested() und fullScreenCancelled().

Der aktuelle Lebenszyklusstatus der Seite.

Die folgenden Einschränkungen werden durch den Setter erzwungen:

• Eine sichtbare Seite muss sich im Zustand Active befinden.
• Wenn die Seite von einem devToolsView inspiziert wird, müssen beide Seiten im Zustand Active verbleiben.
• Eine Seite, die sich im Zustand Discarded befindet, kann nur in den Zustand Active übergehen. Dies führt zu einem Neuladen der Seite.

Dies sind die einzigen harten Grenzen für den Lebenszykluszustand, aber siehe auch recommendedState für die empfohlenen weichen Grenzen.

Diese Eigenschaft wurde in QtWebEngine 1.10 eingeführt.

Siehe auch recommendedState, Page Lifecycle API, und WebEngine Lifecycle Example.

Die Datenmenge der Seite, die geladen wurde, ausgedrückt als ganzzahliger Prozentsatz im Bereich von 0 bis 100.

Gibt true zurück, wenn die HTML-Seite gerade geladen wird, andernfalls false.

Der Hauptframe der Seite auf der obersten Ebene. Alle anderen Frames auf dieser Seite sind als Kinder des Hauptframes zugänglich.

Diese Eigenschaft wurde in QtWebEngine 6.8 eingeführt.

Das aktuelle Profil, das für die Ansicht verwendet wird.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

Siehe auch WebEngineProfile.

Gibt den akustischen Zustand der aktuellen Seite zurück (Audio wurde gerade abgespielt oder nicht).

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Siehe auch audioMuted und recentlyAudibleChanged.

Der empfohlene Grenzwert für den Lebenszyklusstatus der Seite.

Wird der Lebenszyklusstatus auf einen niedrigeren als den empfohlenen Ressourcennutzungsstatus gesetzt, kann dies zu Nebeneffekten wie dem Stoppen der Audiowiedergabe im Hintergrund oder dem Verlust von HTML-Formulareingaben führen. Das Setzen des Lebenszyklusstatus auf einen höheren Ressourcenzustand ist jedoch vollkommen sicher.

Diese Eigenschaft wurde in QtWebEngine 1.10 eingeführt.

Siehe auch lifecycleState, Page Lifecycle API, und WebEngine Lifecycle Example.

Gibt die Prozess-ID (PID) des Renderprozesses zurück, der dem Hauptframe der aktuellen Seite zugeordnet ist.

Wenn noch kein Renderprozess verfügbar ist, wird 0 zurückgegeben.

Diese Eigenschaft wurde in QtWebEngine 1.11 eingeführt.

Siehe auch renderProcessPidChanged.

Scrollposition des Seiteninhalts.

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Von dieser Ansicht verwendete Einstellungen.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

Siehe auch WebEngineSettings.

Der Titel der aktuell angezeigten HTML-Seite. Dies ist ein schreibgeschützter Wert, der den Inhalt des <title> Tags wiedergibt.

touchHandleDelegate bietet eine Vorlage, die visuelle Touch-Handles definiert, die von der Ansicht instanziiert werden, wenn eine Touch-Auswahlbehandlung erforderlich ist.

Die Position, Deckkraft und Sichtbarkeit des Griffs werden automatisch aktualisiert. Der Delegat sollte ein QML-Element oder ein QML-Typ sein, der dieses erbt.

Der folgende Code verwendet einen benutzerdefinierten Berührungsgriff-Delegaten:

WebEngineView {
// ...
    touchHandleDelegate: Rectangle {
        color: "red"
    }
    // ...
}

Die Berührungsgriffe können auch dynamisch umgeschaltet werden:

 Component {
    id: circleTouchHandle
    Rectangle {
        color: "blue"
        radius: 50
    }
}
function showDefaultHandle(isDefault) {
    if (isDefault)
        webEngineView.touchHandleDelegate = circleTouchHandle
    else
        webEngineView.touchHandleDelegate = null
}

Diese Eigenschaft wurde in QtWebEngine 6.4 eingeführt.

Der Ort der aktuell angezeigten HTML-Seite. Diese beschreibbare Eigenschaft bietet die Hauptschnittstelle zum Laden einer Seite in eine Webansicht. Sie funktioniert genauso wie die window.location DOM Eigenschaft.

Siehe auch loadHtml().

Die Sammlung der Benutzerskripte, die mit der Ansicht verbunden sind.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

Siehe auch WebEngineScriptCollection.

Die Web-Channel-Instanz, die von dieser Ansicht verwendet wird. Dieser Kanal verwendet automatisch den internen QtWebEngine Transportmechanismus über Chromium IPC, und wird im Javascript Kontext der Seite, die er rendert, als qt.webChannelTransport angezeigt. Dieses Transportobjekt wird bei der Instanziierung des JavaScript-Gegenstücks von QWebChannel unter Verwendung der Qt WebChannel JavaScript-API verwendet.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

JavaScript-Welt, in der die von dieser Ansicht verwendete Web-Channel-Instanz installiert ist. Die Welt muss eine Zahl zwischen 0 und 256 sein.

Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.

Zoomfaktor für die Ansicht. Gültige Werte liegen im Bereich von 0.25 bis 5.0. Der Standardfaktor ist 1.0.

Diese Eigenschaft wurde in QtWebEngine 1.1 eingeführt.

Dieses Signal wird ausgesendet, wenn sich der Wert von activeFocusOnPress ändert. Es gibt an, ob die Ansicht den aktiven Fokus erhalten soll, wenn sie gedrückt wird.

Dieses Signal wurde in QtWebEngine 1.2 eingeführt.

Siehe auch activeFocusOnPress und setActiveFocusOnPress().

Dieses Signal wird ausgesendet, wenn sich der Wert von muted ändert. Der Wert wird mit der Eigenschaft audioMuted angegeben.

Dieses Signal wurde in QtWebEngine 1.3 eingeführt.

Siehe auch audioMuted und recentlyAudibleChanged.

Dieses Signal wird ausgesendet, wenn ein Authentifizierungsdialog angefordert wird.

Das Signal request kann mit den Methoden des Typs AuthenticationDialogRequest behandelt werden.

Dieses Signal wurde in QtWebEngine 1.4 eingeführt.

Dieses Signal wird ausgegeben, wenn sich die Hintergrundfarbe der Web-Engine-Ansicht ändert.

Dieses Signal wurde in QtWebEngine 1.2 eingeführt.

Dieses Signal wird ausgegeben, wenn beim Laden einer bestimmten Anforderung ein ungültiger Zertifikatsfehler, error, auftritt.

Der Zertifikatsfehler kann mit Hilfe der Methoden des Typs WebEngineCertificateError behandelt werden.

Dieses Signal wurde in QtWebEngine 1.1 eingeführt.

Dieses Signal wird ausgegeben, wenn ein Farbauswahldialog angefordert wird.

Das Signal request kann mit den Methoden des Typs ColorDialogRequest behandelt werden.

Dieses Signal wurde in QtWebEngine 1.4 eingeführt.

Dieses Signal wird ausgesendet, wenn ein Kontextmenü angefordert wird.

Das Signal request kann über die Eigenschaften des Typs ContextMenuRequest behandelt werden.

Dieses Signal wurde in QtWebEngine 1.4 eingeführt.

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 WebEngineDesktopMediaRequest::selectScreen() oder WebEngineDesktopMediaRequest::selectWindow() aufrufen.

Dieses Signal wurde in QtWebEngine 6.7 eingeführt.

Dieses Signal wird ausgegeben, wenn ein Dateiauswahldialog angefordert wird.

Das Signal request kann mit den Methoden des Typs FileDialogRequest behandelt werden.

Dieses Signal wurde in QtWebEngine 1.4 eingeführt.

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

Dieses Signal wurde in QtWebEngine 1.10 eingeführt.

Siehe auch findText() und FindTextResult.

Dieses Signal wird ausgegeben, wenn die Webseite die request für den Vollbildmodus über die JavaScript-API ausgibt.

Dieses Signal wurde in QtWebEngine 1.1 eingeführt.

Siehe auch isFullScreen.

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

Während frameGeometry die Größe der Rahmenränder einschließt, schließt geometry diese aus.

onGeometryChangeRequested: {
    window.x = geometry.x
    window.y = geometry.y
    window.width = geometry.width
    window.height = geometry.height
}

Dieses Signal wurde in QtWebEngine 1.7 eingeführt.

Dieses Signal wird ausgegeben, wenn ein JavaScript-Programm versucht, eine message auf der Konsole des Webbrowsers auszugeben.

Im Falle von 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, d. h. ob sie durch einen Fehler oder ein weniger schwerwiegendes Ereignis ausgelöst wurde.

Wenn kein Handler angegeben wird, protokolliert die Ansicht die Nachrichten in einem js logging category .

Siehe auch Konsolenprotokollierung.

Dieses Signal wird ausgesendet, wenn ein JavaScript-Dialog angefordert wird.

Das Signal request kann mit den Methoden des Typs JavaScriptDialogRequest behandelt werden.

Dieses Signal wurde in QtWebEngine 1.4 eingeführt.

Innerhalb einer mausgesteuerten Schnittstelle wird dieses Signal ausgegeben, wenn ein Mauszeiger über einen Link fährt, was dem mouseover DOM-Ereignis entspricht. Dieses Ereignis kann auch in Touch-Schnittstellen für mouseover -Ereignisse auftreten, die nicht mit preventDefault() abgebrochen werden. hoveredUrl liefert die Position des Links.

Dieses Signal wird ausgegeben, wenn ein Seitenladevorgang beginnt, endet oder fehlschlägt.

Wenn das Signal mit onLoadingChanged behandelt wird, sind verschiedene schreibgeschützte Parameter auf der WebEngineLoadingInfo verfügbar, die von loadingInfo angegeben werden.

Siehe auch loading, LoadStatus, und ErrorDomain.

Dieses Signal wird ausgegeben, wenn die Navigationsanforderung request ausgegeben wird.

Dieses Signal wird ausgegeben, wenn request zum Laden einer Seite in einer separaten Web-Engine-Ansicht aufgerufen wird. Dies kann entweder sein, weil die aktuelle Seite es 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 acceptAsNewWindow() in der Zielansicht verarbeitet. Wenn dieses Signal nicht behandelt wird, schlägt der angeforderte Ladevorgang fehl.

Eine Beispielimplementierung:

QtObject {
    id: windowParent
    // Create the initial browsing windows and open the startup page.
    Component.onCompleted: {
        var firstWindow = windowComponent.createObject(windowParent);
        firstWindow.webView.loadHtml('<input type="button" value="Click!" onclick="window.open(&quot;http://qt.io&quot;)">');
    }

    property Component windowComponent: Window {
        // Destroy on close to release the Window's QML resources.
        // Because it was created with a parent, it won't be garbage-collected.
        onClosing: destroy()
        visible: true

        property WebEngineView webView: webView_
        WebEngineView {
            id: webView_
            anchors.fill: parent

            // Handle the signal. Dynamically create the window and
            // use its WebEngineView as the destination of our request.
            onNewWindowRequested: function(request) {
                var newWindow = windowComponent.createObject(windowParent);
                newWindow.webView.acceptAsNewWindow(request);
            }
        }
    }
}

Dieses Signal wurde in QtWebEngine 2.0 eingeführt.

Siehe auch WebEngineNewWindowRequest und WebEngine Quick Nano Browser.

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.

Dieses Signal wurde in QtWebEngine 1.5 eingeführt.

Siehe auch printToPdf().

Dieses Signal wird ausgegeben, wenn eine Website eine Berechtigungsanfrage stellt (z. B. Geolocation-Zugriff, Erlaubnis zum Senden von Benachrichtigungen). Das Objekt permission kann nach der anfragenden URL und der WebEnginePermission.PermissionType abgefragt werden, um die Erlaubnis zu erteilen oder zu verweigern.

Dieses Signal wurde in QtWebEngine 6.8 eingeführt.

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 QtWebEngine 6.8 wird dieses Signal nur noch für den Hauptrahmen ausgegeben und nicht mehr für jeden Rahmen, der zum Drucken auffordert.

Dieses Signal wurde in QtWebEngine 1.8 eingeführt.

Siehe auch printToPdf.

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

Dieses Signal wurde in QtWebEngine 6.8 eingeführt.

Siehe auch printRequested.

Dieses Signal wird ausgegeben, wenn sich der durch recentlyAudible angegebene hörbare Zustand der Seite ändert, weil Audio abgespielt oder angehalten wird.

Wenn eine Webseite zwei Videos enthält, die nacheinander gestartet werden, wird dieses Signal nur einmal ausgegeben, und zwar für das erste Video, das den Ton erzeugt. Nachdem beide Videos gestoppt wurden, wird das Signal nach dem letzten erzeugten Ton ausgegeben. Das bedeutet, dass das Signal sowohl bei jeder Art von Ton als auch bei völliger Stille auf einer Webseite ausgegeben wird, unabhängig von der Anzahl der Audioströme.

Es kann auch zu unerwünschten Signalemissionen kommen. Wenn zum Beispiel der Ton gestoppt wird, wird dieses Signal zuerst mit dem Wert true und dann mit dem Wert false ausgegeben. Wenn die Tonwiedergabe beginnt, wird das Signal zweimal mit dem Wert true ausgegeben.

Dieses Signal wurde in QtWebEngine 1.3 eingeführt.

Siehe auch recentlyAudible.

Dieses Signal wird ausgegeben, wenn die Webseite versucht, ein benutzerdefiniertes Protokoll zu registrieren, indem sie einen registerProtocolHandler request ausgibt.

Dieses Signal wurde in QtWebEngine 1.7 eingeführt.

Siehe auch RegisterProtocolHandlerRequest.

Wenn noch kein Renderprozess verfügbar ist, wird 0 zurückgegeben. Dieses Signal wird ausgegeben, wenn pid (Prozess-ID) des zugrundeliegenden Renderprozesses der Seite geändert wurde.

Dieses Signal wurde in QtWebEngine 1.11 eingeführt.

Siehe auch renderProcessPid.

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.

Dieses Signal wurde in QtWebEngine 1.2 eingeführt.

Siehe auch RenderProcessTerminationStatus.

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.

Dieses Signal wurde in QtWebEngine 1.9 eingeführt.

Siehe auch WebEngineClientCertificateSelection.

Dieses Signal wird ausgegeben, wenn die Webseite eine request sendet, um einen Tooltip an einer bestimmten Position anzuzeigen.

Dieses Signal wurde in QtWebEngine 1.10 eingeführt.

Siehe auch TooltipRequest.

Dieses Signal wird ausgegeben, wenn ein Touch-Auswahlmenü an einer bestimmten Position angefordert wird.

Das Signal request kann mit den Methoden des Typs TouchSelectionMenuRequest behandelt werden.

Dieses Signal wurde in QtWebEngine 6.3 eingeführt.

Siehe auch TouchSelectionMenuRequest.

Dieses Signal wird ausgegeben, wenn sich der durch wasRecentlyAudible angegebene akustische Zustand der Seite ändert, weil Audio abgespielt oder gestoppt wird.

Dieses Signal wurde in QtWebEngine 1.3 eingeführt.

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

Die Adresse request enthält die Informationen und die API, die für den Abschluss der WebAuth UX-Anfrage erforderlich sind.

Dieses Signal wurde in QtWebEngine 6.7 eingeführt.

Siehe auch QWebEngineWebAuthUxRequest.

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

Dieses Signal wurde in QtWebEngine 1.2 eingeführt.

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

Dieses Signal wurde in QtWebEngine 6.8 eingeführt.

Siehe auch zoomFactor.

Führt die angegebene script im Inhalt der Webansicht aus.

Der Parameter callback ist optional. Wenn eine Callback-Funktion angegeben wird, wird diese nach Beendigung der Ausführung des Skripts aufgerufen.

runJavaScript("document.title", function(result) { console.log(result); });

Von JavaScript können nur einfache Daten 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.

Um Konflikte mit anderen auf der Seite ausgeführten Skripts zu vermeiden, kann die Welt, in der das Skript ausgeführt wird, durch worldId angegeben werden. Die Welt-ID muss zwischen 0 und 256 liegen. Wenn Sie die ID world weglassen, wird das Script in der Welt MainWorld ausgeführt.

Weitere Informationen zum Einfügen von Skripten finden Sie unter Skriptinjektion. Eine alternative Methode zum Einfügen von Skripten finden Sie unter WebEngineView::userScripts.

Behandelt das newWindowRequested Signal durch Öffnen der request in dieser Ansicht.

Diese Methode wurde in QtWebEngine 2.0 eingeführt.

Siehe auch newWindowRequested.

Gibt ein WebEngineAction für die angegebene WebAction action zurück. WebEngineView kümmert sich auch um die Implementierung der Aktion, so dass beim Auslösen die entsprechende Aktion auf der Ansicht ausgeführt wird.

var copyAction = webEngineView.action(WebEngineView.Copy);

Siehe auch WebEngineAction.

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

Diese Methode wurde in QtWebEngine 6.8 eingeführt.

Findet die angegebene Zeichenkette subString in der Seite. Das Signal findTextFinished() wird ausgegeben, wenn eine Zeichenkettensuche abgeschlossen ist.

Um die Suchmarkierung zu löschen, übergeben Sie einfach einen leeren String.

Diese Methode wurde in QtWebEngine 1.1 eingeführt.

Siehe auch findTextFinished().

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 einen leeren String.

findText("Qt", WebEngineView.FindBackward | WebEngineView.FindCaseSensitively);

Diese Methode wurde in QtWebEngine 1.1 eingeführt.

Siehe auch findTextFinished().

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.

Die Funktion resultCallback muss einen ganzzahligen Parameter haben. Er wird mit der Anzahl der gefundenen Vorkommen des subString aufgerufen.

findText("Qt", WebEngineView.FindCaseSensitively, function(matchCount) {
    if (matchCount > 0)
        console.log("'Qt' tokens found:", matchCount);
});

Diese Methode wurde in QtWebEngine 1.1 eingeführt.

Siehe auch findTextFinished().

Setzt die Eigenschaft isFullScreen sofort auf false. Sie kann verwendet werden, um die Browser-Engine zu informieren, wenn das Fenstersystem die Anwendung zwingt, den Vollbildmodus zu verlassen.

ApplicationWindow {
    onVisibilityChanged: {
        if (webEngineView.isFullScreen && visibility != Window.FullScreen)
            webEngineView.fullScreenCancelled()
    }

    WebEngineView {
        id: webEngineView
        // ...
    }
}

Diese Methode wurde in QtWebEngine 1.1 eingeführt.

Siehe auch isFullScreen und fullScreenRequested().

Rückwärtsgehen in der Sitzungshistorie des Browsers, falls möglich. Diese Funktion ist äquivalent zur window.history.back() DOM Methode.

Siehe auch canGoBack.

Wenn offset positiv ist, wird die angegebene Anzahl von Offset-Seiten im aktuellen Sitzungsverlauf vorwärts gelesen. Wenn offset negativ ist, geht es zurück. Wenn der Offset ungültig ist, wird die Seite nicht geändert.

Diese Methode wurde in QtWebEngine 1.1 eingeführt.

Siehe auch goBack() und goForward().

Geht innerhalb der Session-History des Browsers vorwärts, wenn möglich. Diese Funktion ist äquivalent zur window.history.forward() DOM Methode.

Lädt die angegebene html als Inhalt der Webansicht.

Diese Methode bietet eine Alternative auf niedrigerer Ebene zur Eigenschaft url, die HTML-Seiten über eine URL referenziert.

baseUrl ist optional und wird verwendet, um relative URLs im Dokument aufzulösen, wie z. B. 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.

Siehe auch url.

Druckt den aktuellen Inhalt von WebEngineView in ein PDF-Dokument und speichert es unter filePath. Die Größe des Dokuments wird durch den Wert von pageSizeId bestimmt und seine Ausrichtung wird mit orientation festgelegt.

Diese Methode stellt eine asynchrone Anfrage 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().

Wenn Sie pageSizeId weglassen, wird der Standardwert A4 verwendet, wenn Sie orientation weglassen, wird der Standardwert Portrait verwendet.

Diese Methode wurde in QtWebEngine 1.3 eingeführt.

Siehe auch pdfPrintingFinished().

Druckt den aktuellen Inhalt von WebEngineView in ein PDF-Dokument und gibt ihn in einem Byte-Array zurück. Die Größe des Dokuments wird durch den Wert von pageSizeId bestimmt und seine Ausrichtung wird mit orientation bestimmt.

Der resultCallback muss einen String-Parameter übergeben. Dieser String enthält bei erfolgreichem Druck die Daten des Dokuments, andernfalls einen leeren String.

Wenn Sie pageSizeId weglassen, wird der Standardwert A4 verwendet, wenn Sie orientation weglassen, wird der Standardwert Portrait verwendet.

Diese Methode wurde in QtWebEngine 1.3 eingeführt.

Lädt die aktuelle Seite neu. Diese Funktion ist äquivalent zur window.location.reload() DOM Methode.

Siehe auch reloadAndBypassCache().

Lädt die aktuelle Seite neu und ignoriert dabei alle zwischengespeicherten Inhalte.

Diese Methode wurde in QtWebEngine 1.1 eingeführt.

Siehe auch reload().

Ersetzt das aktuelle falsch geschriebene Wort durch replacement.

Diese Methode wurde in QtWebEngine 1.3 eingeführt.

Speichern Sie die aktuelle 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.

Diese Methode wurde in QtWebEngine 6.6 eingeführt.

Siehe auch QWebEngineDownloadRequest::SavePageFormat.

Setzt den aktiven Fokus auf eine angeklickte Web-Engine-Ansicht, wenn arg auf true steht. Durch die Einstellung auf false kann eine Web-Engine-Ansicht verwendet werden, um ein UI-Element zu erstellen, das keinen Fokus erhalten soll. Dies kann in einer hybriden Benutzeroberfläche nützlich sein.

Diese Methode wurde in QtWebEngine 1.2 eingeführt.

Siehe auch activeFocusOnPress, activeFocusOnPressChanged, und WebEngineSettings::focusOnNavigationEnabled.

Stoppt das Laden der aktuellen Seite.

Löst die Web-Aktion action aus.

Diese Methode wurde in QtWebEngine 1.2 eingeführt.

Siehe auch WebAction.