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
- backForwardCacheEnabled : bool
(since QtWebEngine 6.10) - 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
- preferCSSMarginsForPrinting : bool
(since QtWebEngine 6.9) - printElementBackgrounds : bool
(since QtWebEngine 1.4) - printHeaderAndFooter : bool
(since QtWebEngine 6.9) - 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
- touchEventsApiEnabled : bool
(since QtWebEngine 6.9) - touchIconsEnabled : bool
(since QtWebEngine 1.3) - trimAccessibilityIdentifiers : bool
(since QtWebEngine 6.11) - 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.
Dokumentation der Eigenschaft
accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]
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 [since QtWebEngine 1.5]
Nur sichere Ursprünge wie HTTPS sind in der Lage, Geolocation-Funktionen anzufordern. Hier können Sie den Zugriff auf die Geolocation-Funktionen auch für nicht sichere Ursprünge erlauben.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.5 eingeführt.
allowRunningInsecureContent : bool [since QtWebEngine 1.4]
Standardmäßig können HTTPS-Seiten kein JavaScript, CSS, Plugins oder Web-Sockets von HTTP-URLs ausführen. Früher war dies möglich, und dies bietet eine Überschreibungsmöglichkeit, um das alte Verhalten zu erhalten.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]
Erlaubt die Methode window.focus() in JavaScript. Standardmäßig nicht erlaubt.
Diese Eigenschaft wurde in QtWebEngine 1.6 eingeführt.
autoLoadIconsForPage : bool [since QtWebEngine 1.3]
Lädt automatisch Symbole für Webseiten herunter.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
autoLoadImages : bool
Lädt automatisch Bilder auf Webseiten.
Standardmäßig aktiviert.
backForwardCacheEnabled : bool [since QtWebEngine 6.10]
Aktiviert die Unterstützung für den Rückwärts-/Vorwärts-Cache (oder bfcache), um die Rückwärts- und Vorwärtsnavigation zu beschleunigen.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.10 eingeführt.
defaultTextEncoding : string [since QtWebEngine 1.2]
Legt die Standardkodierung fest. Der Wert muss eine Zeichenkette sein, die 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 [since QtWebEngine 1.8]
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 [since QtWebEngine 1.4]
Der Fokus wird auf die Ansicht gelegt, wenn ein Navigationsvorgang 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 [since QtWebEngine 6.7]
Automatisches Rendern aller Webinhalte unter Verwendung eines dunklen Themas.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.7 eingeführt.
fullscreenSupportEnabled : bool [since QtWebEngine 1.2]
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 Attribut ping für Hyperlinks.
Standardmäßig deaktiviert.
imageAnimationPolicy : enumeration [since QtWebEngine 6.8]
Gibt an, 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 Bilder gerendert werden. |
WebEngineSettings.ImageAnimationPolicy.AnimateOnce | Animiert das Bild einmal, wenn die Bilder 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
Ermöglicht 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 [since QtWebEngine 1.7]
Ermöglicht JavaScript-Programmen das Lesen (Einfügen) aus der Zwischenablage und das Schreiben von unkorrigierten Inhalten. 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 entfernte URLs.
Standardmäßig deaktiviert.
localStorageEnabled : bool
Aktiviert die Unterstützung für die lokale HTML 5-Speicherfunktion.
Standardmäßig aktiviert.
navigateOnDropEnabled : bool [since QtWebEngine 6.4]
Gibt an, dass Navigationen durch das 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 [since QtWebEngine 1.9]
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 [since QtWebEngine 1.7]
Unterbindet die Wiedergabe von Medieninhalten, bis der Benutzer mit der Seite interagiert.
Standardmäßig verwendet Qt WebEngine die Chromium-Einstellungen, wie in Änderungen der Autoplay-Richtlinie 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.
preferCSSMarginsForPrinting : bool [since QtWebEngine 6.9]
Schaltet ein, dass beim Drucken einer Webseite CSS-Ränder gegenüber den Standardgrößen (0, 0, 0, 0) bevorzugt werden.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.9 eingeführt.
printElementBackgrounds : bool [since QtWebEngine 1.4]
Schaltet das Drucken von CSS-Hintergründen beim Drucken einer Webseite ein.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.4 eingeführt.
printHeaderAndFooter : bool [since QtWebEngine 6.9]
Legt fest, dass die Druckergebnisse grundlegende Seiteninformationen (URL, Titel, Datum, Seitenzahl) im Kopf- und Fußbereich enthalten sollen. Es liegt in der Verantwortung des Einbetters, genügend Platz für diese Texte zu schaffen, indem er die richtigen oberen und unteren Ränder einstellt.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.9 eingeführt.
readingFromCanvasEnabled : bool [since QtWebEngine 6.6]
Gibt an, dass das Lesen von allen Canvas-Elementen aktiviert ist.
Diese Einstellung wirkt sich auf alle HTML5-Canvas-Elemente aus, unabhängig vom Ursprung, und kann deaktiviert werden, um Canvas-Fingerprinting zu verhindern.
Standardmäßig aktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.6 eingeführt.
screenCaptureEnabled : bool [since QtWebEngine 1.3]
Gibt der Web-Engine an, ob die Bildschirmaufnahme in dieser Anwendung unterstützt wird oder nicht.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
scrollAnimatorEnabled : bool [since QtWebEngine 6.8]
Aktiviert den animierten Bildlauf.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.8 eingeführt.
showScrollBars : bool [since QtWebEngine 1.6]
Zeigt Bildlaufleisten an. 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 die Pfeiltasten nach links, rechts, oben und unten verwendet werden.
Wenn ein Benutzer z. B. die Taste "Rechts" drückt, wird heuristisch ermittelt, ob es ein Element gibt, das er nach rechts erreichen möchte, und welches Element er wahrscheinlich erreichen möchte.
Standardmäßig deaktiviert.
touchEventsApiEnabled : bool [since QtWebEngine 6.9]
Ermöglicht die Unterstützung der JavaScript-API für Berührungsereignisse, d. h., dass die Handler ontouchstart, ontouchend und ontouchmove im Objekt document.window vorhanden sein werden.
Beachten Sie, dass einige Websites diese API verwenden, um zu entscheiden, ob sie auf einem mobilen Gerät oder auf einem Desktop laufen und ihr Design darauf basieren. Dies kann zu unerwünschten Ergebnissen auf Touchscreen-Laptops oder anderen Einrichtungen führen, die ein falsches Touch-Gerät emulieren.
Standardmäßig aktiviert, wenn ein Touch-Gerät vom System erkannt wird, ansonsten deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.9 eingeführt.
touchIconsEnabled : bool [since QtWebEngine 1.3]
Aktiviert die Unterstützung für Berührungssymbole und vorkomponierte Berührungssymbole.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 1.3 eingeführt.
trimAccessibilityIdentifiers : bool [since QtWebEngine 6.11]
Erzwingt die Verwendung des HTML-Attributs "id" als Automatisierungs-ID (QAccessible::Identifier) ohne Änderung. Wenn deaktiviert, wird Qt stattdessen die gesamte Objekthierarchie dem Bezeichner voranstellen.
Standardmäßig deaktiviert.
Diese Eigenschaft wurde in QtWebEngine 6.11 eingeführt.
unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]
Gibt an, wie Navigationsanfragen an URLs mit unbekannten Schemata behandelt werden.
| Konstante | Beschreibung |
|---|---|
WebEngineSettings.DisallowUnknownUrlSchemes | Verbietet alle Navigationsanfragen an URLs mit unbekanntem Schema. |
WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction | Erlaubt Navigationsanfragen an 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 [since QtWebEngine 1.3]
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 [since QtWebEngine 1.7]
Begrenzt WebRTC nur auf öffentliche IP-Adressen. Wenn diese Option 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.
© 2026 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.
