QWebEngineSettings Class
Die Klasse QWebEngineSettings stellt ein Objekt zur Verfügung, um die von QWebEnginePage verwendeten Einstellungen zu speichern. Mehr...
| Kopfzeile: | #include <QWebEngineSettings> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
Öffentliche Typen
| enum | FontFamily { StandardFont, FixedFont, SerifFont, SansSerifFont, CursiveFont, …, PictographFont } |
| enum | FontSize { MinimumFontSize, MinimumLogicalFontSize, DefaultFontSize, DefaultFixedFontSize } |
(since Qt 6.8) enum class | ImageAnimationPolicy { Allow, AnimateOnce, Disallow } |
(since Qt 5.11) enum | UnknownUrlSchemePolicy { DisallowUnknownUrlSchemes, AllowUnknownUrlSchemesFromUserInteraction, AllowAllUnknownUrlSchemes } |
| enum | WebAttribute { AutoLoadImages, JavascriptEnabled, JavascriptCanOpenWindows, JavascriptCanAccessClipboard, LinksIncludedInFocusChain, …, ForceDarkMode } |
Öffentliche Funktionen
| QString | defaultTextEncoding() const |
| QString | fontFamily(QWebEngineSettings::FontFamily which) const |
| int | fontSize(QWebEngineSettings::FontSize type) const |
(since Qt 6.8) QWebEngineSettings::ImageAnimationPolicy | imageAnimationPolicy() const |
| void | resetAttribute(QWebEngineSettings::WebAttribute attribute) |
| void | resetFontFamily(QWebEngineSettings::FontFamily which) |
| void | resetFontSize(QWebEngineSettings::FontSize type) |
(since Qt 6.8) void | resetImageAnimationPolicy() |
(since Qt 5.11) void | resetUnknownUrlSchemePolicy() |
| void | setAttribute(QWebEngineSettings::WebAttribute attribute, bool on) |
| void | setDefaultTextEncoding(const QString &encoding) |
| void | setFontSize(QWebEngineSettings::FontSize type, int size) |
(since Qt 6.8) void | setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy) |
(since Qt 5.11) void | setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy) |
| bool | testAttribute(QWebEngineSettings::WebAttribute attribute) const |
(since Qt 5.11) QWebEngineSettings::UnknownUrlSchemePolicy | unknownUrlSchemePolicy() const |
Detaillierte Beschreibung
QWebEngineSettings ermöglicht die Konfiguration von Browsereigenschaften wie Schriftgrößen und -familien sowie von generischen Attributen wie der JavaScript-Unterstützung. Einzelne Attribute werden mit der Funktion setAttribute() gesetzt. Das WebAttribute enum beschreibt jedes Attribut näher.
Jedes QWebEnginePage Objekt hat sein eigenes QWebEngineSettings Objekt, das die Einstellungen für diese Seite konfiguriert. Wenn eine Einstellung für eine Web-Engine-Seite nicht konfiguriert ist, wird sie in den Einstellungen des Profils nachgeschlagen, zu dem die Seite gehört.
Siehe auch QWebEnginePage::settings() und QWebEngineView::settings().
Dokumentation der Mitgliedstypen
enum QWebEngineSettings::FontFamily
Diese Aufzählung beschreibt die in CSS 2 definierten generischen Schriftfamilien. Weitere Informationen finden Sie im CSS-Standard.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineSettings::StandardFont | 0 | |
QWebEngineSettings::FixedFont | 1 | |
QWebEngineSettings::SerifFont | 2 | |
QWebEngineSettings::SansSerifFont | 3 | |
QWebEngineSettings::CursiveFont | 4 | |
QWebEngineSettings::FantasyFont | 5 | |
QWebEngineSettings::PictographFont | 6 | (hinzugefügt in Qt 5.7, veraltet Qt 6.4) |
enum QWebEngineSettings::FontSize
Diese Aufzählung beschreibt die Schriftgrößen, die über QWebEngineSettings konfiguriert werden können:
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineSettings::MinimumFontSize | 0 | Die harte Mindestschriftgröße. |
QWebEngineSettings::MinimumLogicalFontSize | 1 | Die minimale logische Schriftgröße, die beim Verkleinern angewendet wird. |
QWebEngineSettings::DefaultFontSize | 2 | Die Standard-Schriftgröße für normalen Text. |
QWebEngineSettings::DefaultFixedFontSize | 3 | Die Standardschriftgröße für Text mit festem Zeilenabstand. |
[since Qt 6.8] enum class QWebEngineSettings::ImageAnimationPolicy
Diese Aufzählung beschreibt, wie eine Bildanimation gehandhabt werden soll, wenn die Bildrahmen für die Animation gerendert werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineSettings::ImageAnimationPolicy::Allow | 1 | Ermöglicht die Bildanimation beim Rendern der Bildrahmen. |
QWebEngineSettings::ImageAnimationPolicy::AnimateOnce | 2 | Animiert das Bild einmal, wenn die Bilder gerendert werden. |
QWebEngineSettings::ImageAnimationPolicy::Disallow | 3 | Lässt keine Bildanimation zu, wenn die Bilder gerendert werden. |
Dieses Enum wurde in Qt 6.8 eingeführt.
Siehe auch imageAnimationPolicy, setImageAnimationPolicy, und resetImageAnimationPolicy.
[since Qt 5.11] enum QWebEngineSettings::UnknownUrlSchemePolicy
Diese Aufzählung beschreibt, wie Navigationsanfragen an URLs mit unbekannten Schemata behandelt werden.
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes | 1 | Verweigert alle Navigationsanfragen an URLs mit unbekannten Schemata. |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction | 2 | Erlaubt Navigationsanfragen an URLs mit unbekannten Schemata, die durch Benutzerinteraktion (z. B. Mausklick) ausgelöst werden, während andere Navigationsanfragen (z. B. von JavaScript) unterdrückt werden. |
QWebEngineSettings::AllowAllUnknownUrlSchemes | 3 | Erlaubt alle Navigationsanfragen zu URLs mit unbekannten Schemata. |
Dieses Enum wurde in Qt 5.11 eingeführt.
Siehe auch unknownUrlSchemePolicy, setUnknownUrlSchemePolicy, und resetUnknownUrlSchemePolicy.
enum QWebEngineSettings::WebAttribute
Dieser Enum-Typ spezifiziert Einstellungen für Webseiten:
| Konstante | Wert | Beschreibung |
|---|---|---|
QWebEngineSettings::AutoLoadImages | 0 | Lädt automatisch Bilder für Webseiten herunter. Wenn diese Einstellung deaktiviert ist, werden die Bilder aus dem Cache geladen. Standardmäßig aktiviert. |
QWebEngineSettings::JavascriptEnabled | 1 | Ermöglicht die Ausführung von JavaScript-Programmen auf MainWorld. Standardmäßig aktiviert. |
QWebEngineSettings::JavascriptCanOpenWindows | 2 | Erlaubt JavaScript-Programmen, Popup-Fenster ohne Benutzerinteraktion zu öffnen. Standardmäßig aktiviert. |
QWebEngineSettings::JavascriptCanAccessClipboard | 3 | Ermöglicht JavaScript-Programmen das Schreiben (Kopieren) von bereinigtem Inhalt 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. |
QWebEngineSettings::LinksIncludedInFocusChain | 4 | Schließt Hyperlinks in die Tastaturfokuskette ein. Standardmäßig aktiviert. |
QWebEngineSettings::LocalStorageEnabled | 5 | Aktiviert die Unterstützung für die lokale HTML 5-Speicherfunktion. Standardmäßig aktiviert. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls | 6 | Erlaubt lokalen Ursprungsdokumenten den Zugriff auf entfernte Ressourcen, die normalerweise blockiert wären. Standardmäßig deaktiviert. Hinweis: DnsPrefetchEnabled funktioniert unabhängig von dieser Einstellung und kann, wenn es aktiviert ist, Remote-Zugriffe von lokalen Inhalten verursachen. |
QWebEngineSettings::XSSAuditingEnabled | 7 | Veraltet und hat keine Auswirkungen. |
QWebEngineSettings::SpatialNavigationEnabled | 8 | 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 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. |
QWebEngineSettings::LocalContentCanAccessFileUrls | 9 | Erlaubt lokal geladenen Dokumenten den Zugriff auf andere lokale URLs. Wenn Sie dies deaktivieren, verhält sich QtWebEngine mehr wie Chrome und Firefox in der Standardeinstellung. Standardmäßig aktiviert. |
QWebEngineSettings::HyperlinkAuditingEnabled | 10 | Aktiviert die Unterstützung für das ping -Attribut für Hyperlinks. Standardmäßig deaktiviert. |
QWebEngineSettings::ScrollAnimatorEnabled | 11 | Aktiviert den animierten Bildlauf. Standardmäßig deaktiviert. |
QWebEngineSettings::ErrorPageEnabled | 12 | Aktiviert die Anzeige der eingebauten Fehlerseiten von Chromium. Standardmäßig aktiviert. |
QWebEngineSettings::PluginsEnabled | 13 | Aktiviert die Unterstützung für Pepper-Plugins, wie z.B. den Flash-Player. Standardmäßig deaktiviert. |
QWebEngineSettings::FullScreenSupportEnabled | 14 | Aktiviert die Vollbildunterstützung in einer Anwendung. Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.6) |
QWebEngineSettings::ScreenCaptureEnabled | 15 | Ermöglicht Bildschirmaufnahmen in einer Anwendung. Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.7) |
QWebEngineSettings::WebGLEnabled | 16 | Aktiviert die Unterstützung für HTML 5 WebGL. Standardmäßig aktiviert, wenn verfügbar. (Hinzugefügt in Qt 5.7) |
QWebEngineSettings::Accelerated2dCanvasEnabled | 17 | Gibt an, ob die HTML5 2D Leinwand ein OpenGL Framebuffer sein soll. Dies macht viele Malvorgänge schneller, verlangsamt aber den Pixelzugriff. Standardmäßig aktiviert, wenn verfügbar. (Hinzugefügt in Qt 5.7) |
QWebEngineSettings::AutoLoadIconsForPage | 18 | Automatisches Herunterladen von Symbolen für Webseiten. Standardmäßig aktiviert. (Hinzugefügt in Qt 5.7) |
QWebEngineSettings::TouchIconsEnabled | 19 | Aktiviert Unterstützung für Touch-Icons und vorkomponierte Touch-Icons Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.7) |
QWebEngineSettings::FocusOnNavigationEnabled | 20 | Gibt der mit der Seite verknüpften Ansicht den Fokus, wann immer eine Navigationsoperation stattfindet (laden, stoppen, neu laden, neu laden und Cache umgehen, vorwärts, rückwärts, Inhalt einstellen, usw.). Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.8) |
QWebEngineSettings::PrintElementBackgrounds | 21 | Schaltet das Drucken von CSS-Hintergründen beim Drucken einer Webseite ein. Standardmäßig aktiviert. (Hinzugefügt in Qt 5.8) |
QWebEngineSettings::AllowRunningInsecureContent | 22 | Standardmäßig können HTTPS-Seiten kein JavaScript, CSS, Plugins oder Web-Sockets von HTTP-URLs ausführen. Dies bietet eine Überschreibungsmöglichkeit, um das alte unsichere Verhalten zu erhalten. Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.8) |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins | 23 | Seit Qt 5.7 können nur sichere Quellen wie HTTPS Geolocation-Funktionen anfordern. Dies bietet eine Überschreibungsmöglichkeit, um nicht sicheren Ursprüngen den Zugriff auf Geolocation wieder zu ermöglichen. Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.9) |
QWebEngineSettings::AllowWindowActivationFromJavaScript | 24 | Ermöglicht das Aktivieren von Fenstern mit der JavaScript-Methode window.focus(). Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.10) |
QWebEngineSettings::ShowScrollBars | 25 | Zeigt Bildlaufleisten. Standardmäßig aktiviert. (Hinzugefügt in Qt 5.10) |
QWebEngineSettings::PlaybackRequiresUserGesture | 26 | Unterbindet die Wiedergabe von Medieninhalten, bis der Benutzer mit der Seite interagiert. Standardmäßig verwendet WebEngine die Chromium-Einstellungen, wie in Autoplay Policy Changes beschrieben. Dies ist vergleichbar mit dem Verhalten von Chrome auf Android, während das Standardverhalten bei Deaktivierung dem von Chrome auf Desktops entspricht. Um das Standardverhalten zu überschreiben, deaktivieren Sie diese Einstellung. (Hinzugefügt in Qt 5.11) |
QWebEngineSettings::JavascriptCanPaste | 28 | 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. (Hinzugefügt in Qt 5.11) |
QWebEngineSettings::WebRTCPublicInterfacesOnly | 27 | Begrenzt WebRTC nur auf öffentliche IP-Adressen. Wenn dies 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. (Hinzugefügt in Qt 5.11) |
QWebEngineSettings::DnsPrefetchEnabled | 29 | Legt fest, ob WebEngine versuchen soll, DNS-Einträge vorab zu holen, um das Browsen zu beschleunigen. Standardmäßig deaktiviert. (Hinzugefügt in Qt 5.12) |
QWebEngineSettings::PdfViewerEnabled | 30 | Legt fest, dass PDF-Dokumente im internen PDF-Viewer geöffnet werden, anstatt heruntergeladen zu werden. Standardmäßig aktiviert. (Hinzugefügt in Qt 5.13) |
QWebEngineSettings::NavigateOnDropEnabled | 31 | Legt fest, dass Navigationen durch Ablegen von URLs auf der Ansicht ausgelöst werden können. Standardmäßig aktiviert. (Hinzugefügt in Qt 6.4) |
QWebEngineSettings::ReadingFromCanvasEnabled | 32 | Legt fest, 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. (Hinzugefügt in Qt 6.6) |
QWebEngineSettings::ForceDarkMode | 33 | Legt fest, dass alle Webinhalte mit einem dunklen Thema gerendert werden. Für weitere Informationen, siehe Auto dark theme. Standardmäßig deaktiviert. (Hinzugefügt in Qt 6.7) |
Dokumentation der Mitgliedsfunktionen
QString QWebEngineSettings::defaultTextEncoding() const
Gibt die Standard-Textkodierung zurück.
Siehe auch setDefaultTextEncoding().
QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const
Gibt die aktuelle Schriftfamilie für die angegebene generische Schriftfamilie zurück, which.
int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const
Gibt die Standardschriftgröße für type in Pixeln zurück.
Siehe auch setFontSize().
[since Qt 6.8] QWebEngineSettings::ImageAnimationPolicy QWebEngineSettings::imageAnimationPolicy() const
Gibt die aktuell gewählte Richtlinie für die Behandlung von Bildanimationen beim Rendern von Einzelbildern zurück. Die Voreinstellung ist QWebEngineSettings::ImageAnimationPolicy::Allow.
Diese Funktion wurde in Qt 6.8 eingeführt.
Siehe auch setImageAnimationPolicy und resetImageAnimationPolicy.
void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)
Setzt die Einstellung von attribute auf den Wert zurück, der in dem Profil angegeben ist, zu dem die Seite gehört.
void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)
Setzt die von which angegebene Schriftfamilie auf diejenige zurück, die in dem Profil angegeben ist, zu dem die Seite gehört.
void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)
Setzt die Schriftgröße für type auf die Größe zurück, die in dem Profil angegeben ist, zu dem die Seite gehört.
[since Qt 6.8] void QWebEngineSettings::resetImageAnimationPolicy()
Entfernt die Richtlinie für die Behandlung von Bildanimationen.
Diese Funktion wurde in Qt 6.8 eingeführt.
Siehe auch imageAnimationPolicy und setImageAnimationPolicy.
[since Qt 5.11] void QWebEngineSettings::resetUnknownUrlSchemePolicy()
Entfernt die Richtlinie für die Behandlung von Navigationsanfragen an URLs mit unbekannten Schemata.
Diese Funktion wurde in Qt 5.11 eingeführt.
Siehe auch unknownUrlSchemePolicy und setUnknownUrlSchemePolicy.
void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)
Aktiviert oder deaktiviert die angegebene Funktion attribute je nach dem Wert von on.
void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)
Gibt das Standard-Textkodierungssystem an.
Der Wert von encoding muss eine Zeichenfolge sein, die eine Kodierung wie "utf-8" oder "iso-8859-1" beschreibt. Wenn der Wert leer bleibt, wird ein Standardwert verwendet. Eine ausführlichere Liste von Kodierungsnamen finden Sie unter QTextCodec.
Siehe auch defaultTextEncoding().
void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)
Setzt die Schriftgröße für type auf size in Pixel.
Siehe auch fontSize().
[since Qt 6.8] void QWebEngineSettings::setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy)
Legt die Richtlinie für die Behandlung von Bildanimationen fest, wenn die Bilder auf policy gerendert werden. Die Voreinstellung ist QWebEngineSettings::ImageAnimationPolicy::Allow.
Diese Funktion wurde in Qt 6.8 eingeführt.
Siehe auch imageAnimationPolicy und resetImageAnimationPolicy.
[since Qt 5.11] void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)
Legt die Richtlinie für die Behandlung von Navigationsanforderungen an URLs mit unbekannten Schemata auf policy fest. Die Voreinstellung ist QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.
Diese Funktion wurde in Qt 5.11 eingeführt.
Siehe auch unknownUrlSchemePolicy und resetUnknownUrlSchemePolicy.
bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const
Gibt true zurück, wenn attribute aktiviert ist; andernfalls wird false zurückgegeben.
[since Qt 5.11] QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const
Gibt die aktuell ausgewählte Richtlinie für die Behandlung von Navigationsanforderungen an URLs mit unbekannten Schemata zurück. Die Voreinstellung ist QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.
Diese Funktion wurde in Qt 5.11 eingeführt.
Siehe auch setUnknownUrlSchemePolicy und resetUnknownUrlSchemePolicy.
© 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.
