WebEngineSettings QML Type
Ermöglicht die Konfiguration von Browser-Eigenschaften und -Attributen. Mehr...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
Eigenschaften
- accelerated2dCanvasEnabled : bool
(since QtWebEngine 1.3) - allowGeolocationOnInsecureOrigins : bool
(since QtWebEngine 1.5) - allowRunningInsecureContent : bool
(since QtWebEngine 1.4) - allowWindowActivationFromJavaScript : bool
(since QtWebEngine 1.6) - autoLoadIconsForPage : bool
(since QtWebEngine 1.3) - autoLoadImages : bool
- defaultTextEncoding : string
(since QtWebEngine 1.2) - dnsPrefetchEnabled : bool
(since QtWebEngine 1.8) - errorPageEnabled : bool
- focusOnNavigationEnabled : bool
(since QtWebEngine 1.4) - forceDarkMode : bool
(since QtWebEngine 6.7) - fullscreenSupportEnabled : bool
(since QtWebEngine 1.2) - hyperlinkAuditingEnabled : bool
- imageAnimationPolicy : enumeration
(since QtWebEngine 6.8) - javascriptCanAccessClipboard : bool
- javascriptCanOpenWindows : bool
- javascriptCanPaste : bool
(since QtWebEngine 1.7) - javascriptEnabled : bool
- linksIncludedInFocusChain : bool
- localContentCanAccessFileUrls : bool
- localContentCanAccessRemoteUrls : bool
- localStorageEnabled : bool
- navigateOnDropEnabled : bool
(since QtWebEngine 6.4) - pdfViewerEnabled : bool
(since QtWebEngine 1.9) - playbackRequiresUserGesture : bool
(since QtWebEngine 1.7) - pluginsEnabled : bool
- printElementBackgrounds : bool
(since QtWebEngine 1.4) - readingFromCanvasEnabled : bool
(since QtWebEngine 6.6) - screenCaptureEnabled : bool
(since QtWebEngine 1.3) - scrollAnimatorEnabled : bool
(since QtWebEngine 6.8) - showScrollBars : bool
(since QtWebEngine 1.6) - spatialNavigationEnabled : bool
- touchIconsEnabled : bool
(since QtWebEngine 1.3) - unknownUrlSchemePolicy : enumeration
(since QtWebEngine 1.7) - webGLEnabled : bool
(since QtWebEngine 1.3) - webRTCPublicInterfacesOnly : bool
(since QtWebEngine 1.7)
Detaillierte Beschreibung
Der Typ WebEngineSettings kann zur Konfiguration von Browsereigenschaften und allgemeinen Attributen wie JavaScript-Unterstützung, Fokusverhalten und Zugriff auf Remote-Inhalte verwendet werden. Dieser Typ kann nicht erstellt werden, aber auf die Standardeinstellungen für alle WebEngine-Ansichten kann über die Eigenschaft WebEngine.settings zugegriffen werden.
Jede Web-Engine-Ansicht kann individuelle Einstellungen haben, auf die mit der Eigenschaft WebEngineView.settings zugegriffen werden kann.
Eigenschaft Dokumentation
accelerated2dCanvasEnabled : bool |
Gibt an, ob die HTML 5 2D Leinwand ein OpenGL Framebuffer sein soll. Dies macht viele Malvorgänge schneller, verlangsamt aber den Pixelzugriff.
Standardmäßig aktiviert, wenn verfügbar.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
allowGeolocationOnInsecureOrigins : bool |
Seit Qt 5.7 können nur noch sichere Quellen wie HTTPS Geolocation-Funktionen anfordern. Diese Eigenschaft ermöglicht es, dass auch nicht sichere Ursprünge wieder auf Geolocation zugreifen können.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.5 eingeführt.
allowRunningInsecureContent : bool |
Standardmäßig können HTTPS-Seiten kein JavaScript, CSS, Plugins oder Web-Sockets von HTTP-URLs ausführen. Dies war früher möglich und diese Eigenschaft bietet einen Override, um das alte Verhalten zu erhalten.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
allowWindowActivationFromJavaScript : bool |
Erlaubt die Methode window.focus() in JavaScript. Standardmäßig nicht erlaubt.
Diese Eigenschaft wurde in QtWebEngine 1.6 eingeführt.
autoLoadIconsForPage : bool |
Automatisches Herunterladen von Icons für Webseiten.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
autoLoadImages : bool |
Automatisches Laden von Bildern auf Webseiten.
Standardmäßig aktiviert.
defaultTextEncoding : string |
Setzt die Standardkodierung. Der Wert muss ein String sein, der eine Kodierung wie "utf-8" oder "iso-8859-1" beschreibt.
Bleibt er leer, wird ein Standardwert verwendet.
Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.
dnsPrefetchEnabled : bool |
Aktiviert das spekulative Prefetching von DNS-Einträgen für HTML-Links, bevor diese aktiviert werden.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.8 eingeführt.
errorPageEnabled : bool |
Aktiviert die Anzeige der eingebauten Fehlerseiten von Chromium.
Standardmäßig aktiviert.
focusOnNavigationEnabled : bool |
Der Fokus wird der Ansicht immer dann gegeben, wenn eine Navigationsoperation stattfindet (laden, stoppen, neu laden, neu laden und Cache umgehen, vorwärts, rückwärts, Inhalt einstellen, usw.).
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
forceDarkMode : bool |
Automatisches Rendern aller Webinhalte mit einem dunklen Thema.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.7 eingeführt.
fullscreenSupportEnabled : bool |
Sagt der Web-Engine, ob Vollbild in dieser Anwendung unterstützt wird oder nicht.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.2 eingeführt.
hyperlinkAuditingEnabled : bool |
Aktiviert die Unterstützung für das ping Attribut für Hyperlinks.
Standardmäßig deaktiviert.
imageAnimationPolicy : enumeration |
Legt fest, wie eine Bildanimation gehandhabt werden soll, wenn die Bildrahmen für die Animation gerendert werden.
| Konstante | Beschreibung |
|---|---|
WebEngineSettings.ImageAnimationPolicy.Allow | Erlaubt alle Bildanimationen, wenn die Bildrahmen gerendert werden. |
WebEngineSettings.ImageAnimationPolicy.AnimateOnce | Animiert das Bild einmal, wenn die Bildrahmen gerendert werden. |
WebEngineSettings.ImageAnimationPolicy.Disallow | Lässt alle Bildanimationen beim Rendern der Bildrahmen nicht zu. |
Der Standardwert ist WebEngineSettings.ImageAnimationPolicy.Allow.
Diese Eigenschaft wurde in QtWebEngine 6.8 eingeführt.
javascriptCanAccessClipboard : bool |
Erlaubt JavaScript-Programmen das Schreiben (Kopieren) von geprüften Inhalten in die Zwischenablage. Ein bereinigter Schreibvorgang wird mit den JavaScript-Zwischenablage-API-Aufrufen write und writeText durchgeführt und muss von einer Benutzeraktion begleitet werden.
Ungesäuberte Schreibvorgänge und das Lesen aus der Zwischenablage werden durch javascriptCanPaste aktiviert.
Vor Chromium Version 81 ermöglichte diese Einstellung alle Schreibvorgänge in der Zwischenablage.
Da der uneingeschränkte Zugriff auf die Zwischenablage ein potenzielles Sicherheitsproblem darstellt, wird empfohlen, dass Anwendungen diese Einstellung deaktiviert lassen und stattdessen auf die Berechtigungsanfragen der Funktion ClipboardReadWrite reagieren.
Standardmäßig deaktiviert.
javascriptCanOpenWindows : bool |
Erlaubt JavaScript-Programmen, Popup-Fenster ohne Benutzerinteraktion zu öffnen.
Standardmäßig aktiviert.
javascriptCanPaste : bool |
Erlaubt JavaScript-Programmen das Lesen (Einfügen) aus der Zwischenablage und das Schreiben von unkorrigiertem Inhalt. Ein bereinigter Schreibvorgang wird mit den JavaScript-Zwischenablage-API-Aufrufen write und writeText durchgeführt und muss von einer Benutzeraktion begleitet sein; nicht bereinigte Schreibvorgänge sind alle Schreibvorgänge, die diese Kriterien nicht erfüllen.
Damit diese Einstellung eine Wirkung hat, muss javascriptCanAccessClipboard ebenfalls aktiviert sein.
Da der uneingeschränkte Zugriff auf die Zwischenablage ein potenzielles Sicherheitsproblem darstellt, wird empfohlen, dass Anwendungen diese Einstellung deaktiviert lassen und stattdessen auf die Berechtigungsanfragen der Funktion ClipboardReadWrite reagieren.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.
javascriptEnabled : bool |
Ermöglicht die Ausführung von JavaScript-Programmen.
Standardmäßig aktiviert.
linksIncludedInFocusChain : bool |
Nimmt Hyperlinks in die Tastaturfokuskette auf.
Standardmäßig aktiviert.
localContentCanAccessFileUrls : bool |
Erlaubt lokal geladenen Dokumenten den Zugriff auf andere lokale URLs.
Standardmäßig aktiviert.
localContentCanAccessRemoteUrls : bool |
Erlaubt lokal geladenen Dokumenten den Zugriff auf Remote-URLs.
Standardmäßig deaktiviert.
localStorageEnabled : bool |
Aktiviert die Unterstützung für die lokale HTML 5-Speicherfunktion.
Standardmäßig aktiviert.
navigateOnDropEnabled : bool |
Legt fest, dass Navigationen durch Ablegen von URLs in der Ansicht ausgelöst werden können.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.4 eingeführt.
pdfViewerEnabled : bool |
Legt fest, dass PDF-Dokumente im internen PDF-Viewer geöffnet werden, anstatt heruntergeladen zu werden.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.9 eingeführt.
playbackRequiresUserGesture : bool |
Verhindert das Abspielen von Medieninhalten, bis der Benutzer mit der Seite interagiert.
Standardmäßig verwendet Qt WebEngine die Chromium-Einstellungen, wie in Autoplay Policy Changes beschrieben. Um das Standardverhalten zu überschreiben, muss diese Eigenschaft auf false gesetzt werden.
Hinweis: Das Verhalten ist ähnlich wie bei Chrome auf Android, wenn es aktiviert ist, und ähnlich wie bei Chrome auf Desktops, wenn es deaktiviert ist.
Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.
pluginsEnabled : bool |
Aktiviert die Unterstützung für Pepper-Plugins, wie z. B. den Flash-Player.
Standardmäßig deaktiviert.
printElementBackgrounds : bool |
Schaltet das Drucken von CSS-Hintergründen beim Drucken einer Webseite ein.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
readingFromCanvasEnabled : bool |
Legt fest, dass das Lesen von allen Canvas-Elementen aktiviert ist.
Diese Einstellung wirkt sich auf alle HTML5-Canvas-Elemente aus, unabhängig von ihrer Herkunft, und kann deaktiviert werden, um Canvas-Fingerprinting zu verhindern.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.6 eingeführt.
screenCaptureEnabled : bool |
Sagt der Web-Engine, ob Screen-Capture in dieser Anwendung unterstützt wird oder nicht.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
scrollAnimatorEnabled : bool |
Aktiviert den animierten Bildlauf.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.8 eingeführt.
showScrollBars : bool |
Zeigt Bildlaufleisten. Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.6 eingeführt.
spatialNavigationEnabled : bool |
Aktiviert die räumliche Navigation, d.h. die Möglichkeit, zwischen fokussierbaren Elementen wie Hyperlinks und Formularsteuerelementen auf einer Webseite zu navigieren, indem man die Pfeiltasten nach links, rechts, oben und unten benutzt.
Wenn ein Benutzer beispielsweise die Taste Rechts drückt, ermittelt die Heuristik, ob es ein Element gibt, das er möglicherweise nach rechts erreichen möchte, und welches Element er wahrscheinlich erreichen möchte.
Standardmäßig deaktiviert.
touchIconsEnabled : bool |
Aktiviert die Unterstützung für Berührungssymbole und vorkomponierte Berührungssymbole.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
unknownUrlSchemePolicy : enumeration |
Legt fest, wie Navigationsanfragen an URLs mit unbekannten Schemata behandelt werden.
| Konstante | Beschreibung |
|---|---|
WebEngineSettings.DisallowUnknownUrlSchemes | Verbietet alle Navigationsanfragen an URLs mit unbekannten Schemata. |
WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction | Erlaubt Navigationsanfragen zu URLs mit unbekanntem Schema, die durch Benutzerinteraktion (z.B. Mausklick) ausgelöst werden, während andere Navigationsanfragen (z.B. von JavaScript) unterdrückt werden. |
WebEngineSettings.AllowAllUnknownUrlSchemes | Erlaubt alle Navigationsanfragen an URLs mit unbekanntem Schema. |
Der Standardwert ist WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction.
Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.
webGLEnabled : bool |
Aktiviert die Unterstützung für HTML 5 WebGL.
Standardmäßig aktiviert, wenn verfügbar.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
webRTCPublicInterfacesOnly : bool |
Begrenzt WebRTC nur auf öffentliche IP-Adressen. Wenn sie deaktiviert ist, kann WebRTC auch lokale Netzwerk-IP-Adressen verwenden, aber entfernte Hosts können auch Ihre lokale Netzwerk-IP-Adresse sehen.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.7 eingeführt.
© 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.
