QWebEngineSettings Class

La classe QWebEngineSettings fournit un objet permettant de stocker les paramètres utilisés par QWebEnginePage. Plus...

En-tête : #include <QWebEngineSettings>
CMake : find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)
target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore)
qmake : QT += webenginecore

Types publics

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, …, BackForwardCacheEnabled }

Fonctions publiques

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

Description détaillée

QWebEngineSettings permet de configurer les propriétés du navigateur, telles que la taille et la famille des polices, et les attributs génériques, tels que la prise en charge de JavaScript. Les attributs individuels sont définis à l'aide de la fonction setAttribute(). L'énumération WebAttribute décrit plus en détail chaque attribut.

Chaque objet QWebEnginePage possède son propre objet QWebEngineSettings, qui configure les paramètres de cette page. Si un paramètre n'est pas configuré pour une page de moteur web, il est recherché dans les paramètres du profil auquel la page appartient.

Voir également QWebEnginePage::settings() et QWebEngineView::settings().

Documentation sur les types de membres

enum QWebEngineSettings::FontFamily

Cette énumération décrit les familles de polices génériques définies par CSS 2. Pour plus d'informations, voir la norme CSS.

ConstanteValeurDescription
QWebEngineSettings::StandardFont0
QWebEngineSettings::FixedFont1
QWebEngineSettings::SerifFont2
QWebEngineSettings::SansSerifFont3
QWebEngineSettings::CursiveFont4
QWebEngineSettings::FantasyFont5
QWebEngineSettings::PictographFont6(ajoutée dans Qt 5.7, dépréciée dans Qt 6.4)

enum QWebEngineSettings::FontSize

Cette énumération décrit les tailles de police configurables à l'aide de QWebEngineSettings:

ConstanteValeurDescription
QWebEngineSettings::MinimumFontSize0Taille minimale de la police.
QWebEngineSettings::MinimumLogicalFontSize1La taille minimale logique de la police qui est appliquée lors d'un zoom arrière.
QWebEngineSettings::DefaultFontSize2Taille de police par défaut pour le texte normal.
QWebEngineSettings::DefaultFixedFontSize3Taille de police par défaut pour le texte à hauteur fixe.

[since Qt 6.8] enum class QWebEngineSettings::ImageAnimationPolicy

Cette énumération décrit la manière dont une animation d'image doit être gérée lorsque les images sont rendues pour l'animation.

ConstanteValeurDescription de la constante
QWebEngineSettings::ImageAnimationPolicy::Allow1Permet l'animation de l'image lors du rendu des images.
QWebEngineSettings::ImageAnimationPolicy::AnimateOnce2Anime l'image une seule fois lors du rendu des images.
QWebEngineSettings::ImageAnimationPolicy::Disallow3Désactive l'animation de l'image lors du rendu des images.

Cette énumération a été introduite dans Qt 6.8.

Voir aussi imageAnimationPolicy, setImageAnimationPolicy, et resetImageAnimationPolicy.

[since Qt 5.11] enum QWebEngineSettings::UnknownUrlSchemePolicy

Cette énumération décrit la manière dont sont traitées les demandes de navigation vers des URL dont le schéma est inconnu.

ConstanteValeurDescription
QWebEngineSettings::DisallowUnknownUrlSchemes1Interdit toutes les demandes de navigation vers des URL dont le schéma est inconnu.
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction2Autorise les demandes de navigation vers des URL dont le schéma est inconnu et qui proviennent d'une interaction de l'utilisateur (comme un clic de souris), tandis que les autres demandes de navigation (par exemple, celles provenant de JavaScript) sont supprimées.
QWebEngineSettings::AllowAllUnknownUrlSchemes3Autorise toutes les demandes de navigation vers des URL dont le schéma est inconnu.

Cette énumération a été introduite dans Qt 5.11.

Voir aussi unknownUrlSchemePolicy, setUnknownUrlSchemePolicy, et resetUnknownUrlSchemePolicy.

enum QWebEngineSettings::WebAttribute

Ce type d'énumération spécifie les paramètres pour les pages web :

ConstanteValeurDescription
QWebEngineSettings::AutoLoadImages0Télécharge automatiquement les images des pages web. Lorsque ce paramètre est désactivé, les images sont chargées à partir du cache. Activé par défaut.
QWebEngineSettings::JavascriptEnabled1Permet l'exécution de programmes JavaScript sur le site MainWorld. Activé par défaut.
QWebEngineSettings::JavascriptCanOpenWindows2Permet aux programmes JavaScript d'ouvrir des fenêtres contextuelles sans interaction de l'utilisateur. Activé par défaut.
QWebEngineSettings::JavascriptCanAccessClipboard3Permet aux programmes JavaScript d'écrire (copier) un contenu assaini dans le presse-papiers. Une écriture assainie est effectuée à l'aide des appels de l'API du presse-papiers JavaScript write et writeText et doit être accompagnée d'une action de l'utilisateur. Les écritures non assainies et la lecture du presse-papiers sont activées par JavascriptCanPaste. Avant la version 81 de Chromium, ce paramètre activait toutes les écritures dans le presse-papiers. L'accès illimité au presse-papiers étant un problème de sécurité potentiel, il est recommandé aux applications de laisser ce paramètre désactivé et de répondre plutôt aux demandes d'autorisation de la fonctionnalité ClipboardReadWrite. Désactivé par défaut.
QWebEngineSettings::LinksIncludedInFocusChain4Inclut les hyperliens dans la chaîne de focalisation du clavier. Activé par défaut.
QWebEngineSettings::LocalStorageEnabled5Active la prise en charge de la fonction de stockage local de HTML 5. Activé par défaut.
QWebEngineSettings::LocalContentCanAccessRemoteUrls6Permet aux documents d'origine locale d'accéder à des ressources distantes qui seraient normalement bloquées. Désactivé par défaut. Remarque : le paramètre DnsPrefetchEnabled ci-dessous fonctionne indépendamment de ce paramètre et peut, s'il est activé, entraîner des accès à distance à partir du contenu local.
QWebEngineSettings::XSSAuditingEnabled7Ce paramètre est obsolète et n'a aucun effet.
QWebEngineSettings::SpatialNavigationEnabled8Active la fonction de navigation spatiale, c'est-à-dire la possibilité de naviguer entre les éléments focalisables, tels que les hyperliens et les contrôles de formulaire, sur une page web en utilisant les touches fléchées gauche, droite, haut et bas. Par exemple, si un utilisateur appuie sur la touche Droite, l'heuristique détermine s'il y a un élément qu'il pourrait essayer d'atteindre vers la droite et quel est l'élément qu'il veut probablement atteindre. Désactivé par défaut.
QWebEngineSettings::LocalContentCanAccessFileUrls9Permet aux documents chargés localement d'accéder à d'autres URL locales. En désactivant cette option, QtWebEngine se comporte davantage comme Chrome et Firefox par défaut. Activé par défaut.
QWebEngineSettings::HyperlinkAuditingEnabled10Active la prise en charge de l'attribut ping pour les hyperliens. Désactivé par défaut.
QWebEngineSettings::ScrollAnimatorEnabled11Active le défilement animé. Désactivé par défaut.
QWebEngineSettings::ErrorPageEnabled12Permet d'afficher les pages d'erreur intégrées de Chromium. Activé par défaut.
QWebEngineSettings::PluginsEnabled13Active la prise en charge des plugins Pepper, tels que le lecteur Flash. Désactivé par défaut.
QWebEngineSettings::FullScreenSupportEnabled14Active la prise en charge du plein écran dans une application. Désactivé par défaut. (Ajouté dans Qt 5.6)
QWebEngineSettings::ScreenCaptureEnabled15Active la capture d'écran dans une application. Désactivé par défaut. (Ajouté dans Qt 5.7)
QWebEngineSettings::WebGLEnabled16Active la prise en charge de HTML 5 WebGL. Activé par défaut si disponible. (Ajouté dans Qt 5.7)
QWebEngineSettings::Accelerated2dCanvasEnabled17Spécifie si le canevas 2D HTML5 doit être un framebuffer OpenGL. Cela rend de nombreuses opérations de peinture plus rapides, mais ralentit l'accès aux pixels. Activé par défaut s'il est disponible. (Ajouté dans Qt 5.7)
QWebEngineSettings::AutoLoadIconsForPage18Télécharge automatiquement les icônes pour les pages web. Activé par défaut. (Ajouté dans Qt 5.7)
QWebEngineSettings::TouchIconsEnabled19Active la prise en charge des icônes tactiles et des icônes tactiles précomposées Désactivé par défaut. (Ajouté dans Qt 5.7)
QWebEngineSettings::FocusOnNavigationEnabled20Donne la priorité à la vue associée à la page, chaque fois qu'une opération de navigation se produit (charger, arrêter, recharger, recharger et contourner le cache, avancer, reculer, définir le contenu, et ainsi de suite). Désactivé par défaut. (Ajouté dans Qt 5.8)
QWebEngineSettings::PrintElementBackgrounds21Active l'impression des arrière-plans CSS lors de l'impression d'une page web. Activé par défaut. (Ajouté dans Qt 5.8)
QWebEngineSettings::AllowRunningInsecureContent22Par défaut, les pages HTTPS ne peuvent pas exécuter de JavaScript, CSS, plugins ou web-sockets à partir d'URL HTTP. Cette option permet d'obtenir l'ancien comportement non sécurisé. Désactivé par défaut. (Ajouté dans Qt 5.8)
QWebEngineSettings::AllowGeolocationOnInsecureOrigins23Depuis Qt 5.7, seules les origines sécurisées telles que HTTPS ont pu demander des fonctionnalités de géolocalisation. Ceci fournit une surcharge pour permettre aux origines non sécurisées d'accéder à nouveau à la géolocalisation. Désactivé par défaut. (Ajouté dans Qt 5.9)
QWebEngineSettings::AllowWindowActivationFromJavaScript24Permet d'activer les fenêtres en utilisant la méthode JavaScript window.focus(). Désactivé par défaut. (Ajouté dans Qt 5.10)
QWebEngineSettings::ShowScrollBars25Affiche les barres de défilement. Activé par défaut. (Ajouté dans Qt 5.10)
QWebEngineSettings::PlaybackRequiresUserGesture26Inhibe la lecture du contenu multimédia jusqu'à ce que l'utilisateur interagisse avec la page. Par défaut, WebEngine utilise les paramètres de Chromium, comme décrit dans la section Modifications de la politique de lecture automatique. Ce comportement est similaire à celui de Chrome sur Android, tandis que le comportement par défaut lorsqu'il est désactivé est similaire à celui de Chrome sur les ordinateurs de bureau. Pour remplacer le comportement par défaut, désactivez ce paramètre. (Ajouté dans Qt 5.11)
QWebEngineSettings::JavascriptCanPaste28Permet aux programmes JavaScript de lire (coller) à partir du presse-papiers et d'écrire du contenu non aseptisé. L'écriture aseptisée est réalisée à l'aide des appels de l'API JavaScript Clipboard write et writeText et doit être accompagnée d'une action de l'utilisateur ; les écritures non aseptisées sont toutes les écritures qui ne répondent pas à ces critères. Pour que ce paramètre ait un effet, JavascriptCanAccessClipboard doit également être activé. L'accès illimité au presse-papiers pouvant poser des problèmes de sécurité, il est recommandé aux applications de laisser ce paramètre désactivé et de répondre plutôt aux demandes d'autorisation de la fonctionnalité ClipboardReadWrite. Désactivé par défaut. (Ajouté dans Qt 5.11)
QWebEngineSettings::WebRTCPublicInterfacesOnly27Limite WebRTC aux adresses IP publiques uniquement. Lorsqu'il est désactivé, WebRTC peut également utiliser les adresses IP du réseau local, mais les hôtes distants peuvent également voir l'adresse IP de votre réseau local. Désactivé par défaut. (Ajouté dans Qt 5.11)
QWebEngineSettings::DnsPrefetchEnabled29Indique si WebEngine essaiera de récupérer les entrées DNS pour accélérer la navigation. Désactivé par défaut. (Ajouté dans Qt 5.12)
QWebEngineSettings::PdfViewerEnabled30Spécifie que les documents PDF seront ouverts dans la visionneuse PDF interne au lieu d'être téléchargés. Activé par défaut. (Ajouté dans Qt 5.13)
QWebEngineSettings::NavigateOnDropEnabled31Spécifie que les navigations peuvent être déclenchées en déposant des URL sur la vue. Activé par défaut. (Ajouté dans Qt 6.4)
QWebEngineSettings::ReadingFromCanvasEnabled32Spécifie que la lecture de tous les éléments du canevas est activée. Ce paramètre aura un impact sur tous les éléments HTML5 canvas, quelle que soit leur origine, et peut être désactivé pour éviter l'empreinte digitale du canvas. Activé par défaut. (Ajouté dans Qt 6.6)
QWebEngineSettings::ForceDarkMode33Spécifie que tous les contenus web seront rendus en utilisant un thème sombre. Pour plus d'informations, voir Thème sombre automatique. Désactivé par défaut. (Ajouté dans Qt 6.7)
QWebEngineSettings::PrintHeaderAndFooter34Spécifie que les résultats de l'impression contiendront des informations de base sur la page (URL, titre, date, numéro de page) dans l'en-tête et le pied de page. Il incombe à l'intégrateur de prévoir suffisamment d'espace pour ces textes en définissant des marges supérieures et inférieures adéquates. Désactivé par défaut. (Ajouté dans Qt 6.9)
QWebEngineSettings::PreferCSSMarginsForPrinting35Active la préférence des marges CSS sur les marges de la page QPageLayout spécifiée. Désactivé par défaut. (Ajouté dans Qt 6.9)
QWebEngineSettings::TouchEventsApiEnabled36Active la prise en charge de l'API des événements tactiles JavaScript, ce qui signifie que les gestionnaires ontouchstart, ontouchend et ontouchmove seront présents dans l'objet document.window. Activé par défaut si un dispositif tactile est détecté par le système et désactivé dans le cas contraire. (Ajouté dans Qt Designer 6.9) Notez que certains sites web utilisent cette API pour décider s'ils fonctionnent sur un appareil mobile ou sur un ordinateur de bureau et basent leur conception sur cette décision. Cela peut entraîner des résultats indésirables sur les ordinateurs portables à écran tactile ou d'autres configurations qui émulent un faux périphérique tactile.
QWebEngineSettings::BackForwardCacheEnabled37Active la prise en charge du cache arrière/avant (ou bfcache) pour accélérer la navigation arrière et avant. Désactivé par défaut. (Ajouté dans Qt 6.10)

Documentation des fonctions membres

QString QWebEngineSettings::defaultTextEncoding() const

Renvoie l'encodage de texte par défaut.

Voir aussi setDefaultTextEncoding().

QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const

Renvoie la famille de polices actuelle pour la famille de polices générique spécifiée, which.

int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const

Renvoie la taille de police par défaut pour type en pixels.

Voir aussi setFontSize().

[since Qt 6.8] QWebEngineSettings::ImageAnimationPolicy QWebEngineSettings::imageAnimationPolicy() const

Renvoie la politique actuellement sélectionnée pour gérer l'animation de l'image lors du rendu des images. La valeur par défaut est QWebEngineSettings::ImageAnimationPolicy::Allow.

Cette fonction a été introduite dans Qt 6.8.

Voir également setImageAnimationPolicy et resetImageAnimationPolicy.

void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)

Réinitialise le paramètre attribute à la valeur spécifiée dans le profil auquel la page appartient.

void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)

Réinitialise la famille de polices spécifiée par which à celle spécifiée dans le profil auquel la page appartient.

void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)

Réinitialise la taille de la police pour type à la taille spécifiée dans le profil auquel la page appartient.

[since Qt 6.8] void QWebEngineSettings::resetImageAnimationPolicy()

Supprime la politique de gestion de l'animation des images.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi imageAnimationPolicy et setImageAnimationPolicy.

[since Qt 5.11] void QWebEngineSettings::resetUnknownUrlSchemePolicy()

Supprime la politique de traitement des requêtes de navigation vers des URL dont les schémas sont inconnus.

Cette fonction a été introduite dans Qt 5.11.

Voir aussi unknownUrlSchemePolicy et setUnknownUrlSchemePolicy.

void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)

Active ou désactive la fonction attribute spécifiée en fonction de la valeur de on.

void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)

Spécifie le système d'encodage de texte par défaut.

La valeur de encoding doit être une chaîne décrivant un encodage tel que "utf-8" ou "iso-8859-1". Si elle est vide, une valeur par défaut sera utilisée. Pour une liste plus complète de noms d'encodage, voir QTextCodec.

Voir aussi defaultTextEncoding().

void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)

Définit la taille de la police de type à size en pixels.

Voir aussi fontSize().

[since Qt 6.8] void QWebEngineSettings::setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy)

Définit la politique de gestion de l'animation des images lorsque les images sont rendues à policy. La valeur par défaut est QWebEngineSettings::ImageAnimationPolicy::Allow.

Cette fonction a été introduite dans Qt 6.8.

Voir aussi imageAnimationPolicy et resetImageAnimationPolicy.

[since Qt 5.11] void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)

Définit la politique de traitement des requêtes de navigation vers des URL avec des schémas inconnus à policy. La valeur par défaut est QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.

Cette fonction a été introduite dans Qt 5.11.

Voir aussi unknownUrlSchemePolicy et resetUnknownUrlSchemePolicy.

bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const

Renvoie true si attribute est activé ; sinon, renvoie false.

[since Qt 5.11] QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const

Renvoie la politique actuellement sélectionnée pour traiter les demandes de navigation vers des URL dont le schéma est inconnu. La valeur par défaut est QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.

Cette fonction a été introduite dans Qt 5.11.

Voir aussi setUnknownUrlSchemePolicy et 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.