webEngineFrame QML Value Type
webEngineFrame bietet Informationen über und Kontrolle über einen Seitenrahmen. Mehr...
| Import Statement: | import QtWebEngine |
| Since: | Qt 6.8 |
| In C++: | QWebEngineFrame |
Eigenschaften
Methoden
- void printToPdf(string filePath)
- void printToPdf(variant callback)
- void runJavaScript(string script, variant callback)
- void runJavaScript(string script, uint worldId, variant callback)
Ausführliche Beschreibung
Ein Web-Engine-Frame stellt einen einzelnen Frame innerhalb einer Webseite dar, wie z. B. die von <frame> oder <iframe> erstellten HTML-Elemente. Ein aktives WebEngineView hat einen oder mehrere Frames, die in einer Baumstruktur angeordnet sind. Auf den obersten Frame, die Wurzel dieses Baums, kann über die Eigenschaft mainFrame der Ansicht zugegriffen werden.
Die Lebensdauer eines Frames ist höchstens so lang wie das WebEngineView Objekt, das ihn erzeugt hat. Frames können jedoch spontan und dynamisch erstellt und gelöscht werden, zum Beispiel durch Navigation und Skriptausführung.
Eigenschaft Dokumentation
htmlName : string |
Gibt den Wert des HTML-Attributs name des Frames zurück oder eine leere Zeichenkette, wenn der Frame keine hat.
Wenn der Frame nicht gefunden werden konnte, wird ein leerer String zurückgegeben.
Siehe auch name.
isMainFrame : bool |
Gibt true zurück, wenn dieses Objekt den Hauptrahmen der Seite darstellt; andernfalls false.
isValid : bool |
Gibt true zurück, wenn dieses Objekt einen vorhandenen Frame darstellt; andernfalls false.
Sobald ein Frame ungültig ist, wird er nie wieder gültig.
name : string |
Gibt den Namen des Frames zurück, d. h. das, was in JavaScript von window.name zurückgegeben würde.
Wenn der Frame nicht gefunden werden konnte, wird ein leerer String zurückgegeben.
Siehe auch htmlName.
size : size |
Gibt die Größe des Frames innerhalb des Ansichtsfensters zurück.
Wenn der Frame nicht gefunden werden konnte, wird eine Standardgröße mit den Abmessungen (-1, -1) zurückgegeben.
url : url |
Gibt die URL des Inhalts zurück, der derzeit in diesem Frame geladen ist.
Wenn der Frame nicht gefunden werden konnte, wird eine leere URL zurückgegeben.
Dokumentation der Methode
Führt den in script enthaltenen JavaScript-Code in diesem Frame aus, ohne zu prüfen, ob das DOM der Seite aufgebaut wurde.
Um Konflikte mit anderen auf der Seite ausgeführten Skripten zu vermeiden, wird die Welt, in der das Skript ausgeführt wird, durch worldId angegeben. Die Werte für die Welt-ID sind die gleichen wie bei QWebEngineScript::ScriptWorldId und liegen zwischen 0 und 256. Wenn Sie die ID world weglassen, wird das Skript in der Welt MainWorld ausgeführt.
Der Parameter callback ist optional. Wenn eine Callback-Funktion angegeben wird, wird sie nach Beendigung der Ausführung des Skripts aufgerufen.
frame.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.
Das Skript wird in der gleichen Welt ausgeführt wie andere Skripte, die Teil der geladenen Site sind.
Warnung: Führen Sie keine langen Routinen in der Callback-Funktion aus, da dies das Rendering des Webinhalts blockieren könnte.
Weitere Informationen über das Einfügen von Skripten finden Sie unter Skriptinjektion. Eine alternative Methode zum Einfügen von Skripten finden Sie unter WebEngineView::userScripts.
void printToPdf(string filePath) |
Druckt den aktuellen Inhalt des Frames in ein PDF-Dokument und speichert es unter filePath. Das resultierende Dokument hat die Seitengröße A4 und die Ausrichtung im Hochformat.
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 WebEngineView::pdfPrintingFinished().
Siehe auch WebEngineView::pdfPrintingFinished().
void printToPdf(variant callback) |
Druckt den aktuellen Inhalt des Frames in ein PDF-Dokument und gibt ihn in einem Byte-Array zurück. Das resultierende Dokument hat die Seitengröße A4 und die Ausrichtung Hochformat.
Die Funktion callback muss einen String-Parameter enthalten. Dieser String enthält bei erfolgreichem Druck die Daten des Dokuments, andernfalls einen leeren String.
© 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.
