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, …, TrimAccessibilityIdentifiers } |
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.
| Constante | Valeur |
|---|---|
QWebEngineSettings::StandardFont | 0 |
QWebEngineSettings::FixedFont | 1 |
QWebEngineSettings::SerifFont | 2 |
QWebEngineSettings::SansSerifFont | 3 |
QWebEngineSettings::CursiveFont | 4 |
QWebEngineSettings::FantasyFont | 5 |
QWebEngineSettings::PictographFont (since Qt 5.7, deprecated in Qt 6.4) | 6 |
enum QWebEngineSettings::FontSize
Cette énumération décrit les tailles de police configurables à l'aide de QWebEngineSettings:
| Constante | Valeur | Description |
|---|---|---|
QWebEngineSettings::MinimumFontSize | 0 | Taille minimale de la police. |
QWebEngineSettings::MinimumLogicalFontSize | 1 | La taille minimale logique de la police qui est appliquée lors d'un zoom arrière. |
QWebEngineSettings::DefaultFontSize | 2 | Taille de police par défaut pour le texte normal. |
QWebEngineSettings::DefaultFixedFontSize | 3 | Taille 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.
| Constante | Valeur | Description de la constante |
|---|---|---|
QWebEngineSettings::ImageAnimationPolicy::Allow | 1 | Permet l'animation de l'image lors du rendu des images. |
QWebEngineSettings::ImageAnimationPolicy::AnimateOnce | 2 | Anime l'image une seule fois lors du rendu des images. |
QWebEngineSettings::ImageAnimationPolicy::Disallow | 3 | Dé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.
| Constante | Valeur | Description |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes | 1 | Interdit toutes les demandes de navigation vers des URL dont le schéma est inconnu. |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction | 2 | Autorise 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::AllowAllUnknownUrlSchemes | 3 | Autorise 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 :
| Constante | Valeur | Description |
|---|---|---|
QWebEngineSettings::AutoLoadImages | 0 | Té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::JavascriptEnabled | 1 | Permet l'exécution de programmes JavaScript sur le site MainWorld. Activé par défaut. |
QWebEngineSettings::JavascriptCanOpenWindows | 2 | Permet aux programmes JavaScript d'ouvrir des fenêtres contextuelles sans interaction de l'utilisateur. Activé par défaut. |
QWebEngineSettings::JavascriptCanAccessClipboard | 3 | Permet 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::LinksIncludedInFocusChain | 4 | Inclut les hyperliens dans la chaîne de focalisation du clavier. Activé par défaut. |
QWebEngineSettings::LocalStorageEnabled | 5 | Active la prise en charge de la fonction de stockage local de HTML 5. Activé par défaut. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls | 6 | Permet aux documents d'origine locale d'accéder à des ressources distantes qui seraient normalement bloquées. Désactivé par défaut. Note DnsPrefetchEnabled ci-dessous fonctionne indépendamment de ce paramètre et peut, s'il est activé, provoquer des accès distants à partir du contenu local. |
QWebEngineSettings::XSSAuditingEnabled | 7 | Ce paramètre est obsolète et n'a aucun effet. |
QWebEngineSettings::SpatialNavigationEnabled | 8 | Active 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::LocalContentCanAccessFileUrls | 9 | Permet 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::HyperlinkAuditingEnabled | 10 | Active la prise en charge de l'attribut ping pour les hyperliens. Désactivé par défaut. |
QWebEngineSettings::ScrollAnimatorEnabled | 11 | Active le défilement animé. Désactivé par défaut. |
QWebEngineSettings::ErrorPageEnabled | 12 | Permet d'afficher les pages d'erreur intégrées de Chromium. Activé par défaut. |
QWebEngineSettings::PluginsEnabled (since Qt 5.6) | 13 | Active la prise en charge des plugins Pepper, tels que le lecteur Flash. Désactivé par défaut. |
QWebEngineSettings::FullScreenSupportEnabled (since Qt 5.6) | 14 | Active la prise en charge du plein écran dans une application. Désactivé par défaut. |
QWebEngineSettings::ScreenCaptureEnabled (since Qt 5.7) | 15 | Active la capture d'écran dans une application. Désactivé par défaut. |
QWebEngineSettings::WebGLEnabled (since Qt 5.7) | 16 | Active la prise en charge de HTML 5 WebGL. Activé par défaut si disponible. |
QWebEngineSettings::Accelerated2dCanvasEnabled (since Qt 5.7) | 17 | Spécifie si le canevas 2D HTML5 doit être un framebuffer OpenGL. Cela permet d'accélérer de nombreuses opérations de peinture, mais ralentit l'accès aux pixels. Activé par défaut s'il est disponible. |
QWebEngineSettings::AutoLoadIconsForPage (since Qt 5.7) | 18 | Télécharge automatiquement les icônes pour les pages web. Activé par défaut. |
QWebEngineSettings::TouchIconsEnabled (since Qt 5.7) | 19 | Active la prise en charge des icônes tactiles et des icônes tactiles précomposées Désactivé par défaut. |
QWebEngineSettings::FocusOnNavigationEnabled (since Qt 5.8) | 20 | Donne 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. |
QWebEngineSettings::PrintElementBackgrounds (since Qt 5.8) | 21 | Active l'impression des arrière-plans CSS lors de l'impression d'une page web. Activé par défaut. |
QWebEngineSettings::AllowRunningInsecureContent (since Qt 5.8) | 22 | Par 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. |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins (since Qt 5.9) | 23 | Seules les origines sécurisées telles que HTTPS peuvent demander des fonctions de géolocalisation. Cette option permet d'autoriser les origines non sécurisées à accéder à la géolocalisation. Désactivé par défaut. |
QWebEngineSettings::AllowWindowActivationFromJavaScript (since Qt 5.10) | 24 | Permet d'activer les fenêtres en utilisant la méthode JavaScript window.focus(). Désactivé par défaut. |
QWebEngineSettings::ShowScrollBars (since Qt 5.10) | 25 | Affiche les barres de défilement. Activé par défaut. |
QWebEngineSettings::PlaybackRequiresUserGesture (since Qt 5.11) | 26 | Inhibe 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. |
QWebEngineSettings::JavascriptCanPaste (since Qt 5.11) | 28 | Active JavaScript execCommand("paste"). Cela nécessite également d'activer JavascriptCanAccessClipboard. 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. |
QWebEngineSettings::WebRTCPublicInterfacesOnly (since Qt 5.11) | 27 | Limite WebRTC aux adresses IP publiques uniquement. Lorsque cette option est désactivée, 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. |
QWebEngineSettings::DnsPrefetchEnabled (since Qt 5.12) | 29 | Indique si WebEngine essaiera de récupérer les entrées DNS pour accélérer la navigation. Désactivé par défaut. |
QWebEngineSettings::PdfViewerEnabled (since Qt 5.13) | 30 | Spécifie que les documents PDF seront ouverts dans la visionneuse PDF interne au lieu d'être téléchargés. Activé par défaut. |
QWebEngineSettings::NavigateOnDropEnabled (since Qt 6.4) | 31 | Spécifie que les navigations peuvent être déclenchées en déposant des URL sur la vue. Activé par défaut. |
QWebEngineSettings::ReadingFromCanvasEnabled (since Qt 6.6) | 32 | Spé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. |
QWebEngineSettings::ForceDarkMode (since Qt 6.7) | 33 | Spécifie que tous les contenus web seront rendus à l'aide d'un thème sombre. Pour plus d'informations, voir Thème sombre automatique. Désactivé par défaut. |
QWebEngineSettings::PrintHeaderAndFooter (since Qt 6.9) | 34 | Spécifie que les résultats de l'impression contiendront des informations de base sur la page (URL, titre, date, numéro de page) dans la zone d'en-tête et de 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. |
QWebEngineSettings::PreferCSSMarginsForPrinting (since Qt 6.9) | 35 | Active la préférence des marges CSS sur les marges de la page QPageLayout spécifiée. Désactivé par défaut. |
QWebEngineSettings::TouchEventsApiEnabled (since Qt 6.9) | 36 | Active 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. 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::BackForwardCacheEnabled (since Qt 6.10) | 37 | Active 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. |
QWebEngineSettings::TrimAccessibilityIdentifiers (since Qt 6.11) | 38 | Force l'attribut HTML 'id' à être utilisé comme ID d'automatisation (QAccessible::Identifier) sans modification. Si cette option est désactivée, Qt ajoutera l'ensemble de la hiérarchie de l'objet à l'identifiant. Désactivé par défaut. |
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.
© 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.
