QWebEngineSettings Class
La clase QWebEngineSettings proporciona un objeto para almacenar la configuración utilizada por QWebEnginePage. Más...
| Cabecera: | #include <QWebEngineSettings> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS WebEngineCore)target_link_libraries(mytarget PRIVATE Qt6::WebEngineCore) |
| qmake: | QT += webenginecore |
Tipos Públicos
| 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 } |
Funciones Públicas
| 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 |
Descripción detallada
QWebEngineSettings permite configurar propiedades del navegador, como tamaños y familias de fuentes, y atributos genéricos, como la compatibilidad con JavaScript. Los atributos individuales se configuran mediante la función setAttribute(). El enum WebAttribute describe con más detalle cada atributo.
Cada objeto QWebEnginePage tiene su propio objeto QWebEngineSettings, que configura los parámetros para esa página. Si un ajuste no está configurado para una página del motor web, se busca en los ajustes del perfil al que pertenece la página.
Véase también QWebEnginePage::settings() y QWebEngineView::settings().
Documentación de tipos de miembros
enum QWebEngineSettings::FontFamily
Este enum describe las familias de fuentes genéricas definidas por CSS 2. Para más información, consulte el estándar CSS.
| Constante | Valor |
|---|---|
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
Este enum describe los tamaños de fuente configurables a través de QWebEngineSettings:
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineSettings::MinimumFontSize | 0 | El tamaño de fuente mínimo. |
QWebEngineSettings::MinimumLogicalFontSize | 1 | El tamaño de fuente lógico mínimo que se aplica al alejar la imagen. |
QWebEngineSettings::DefaultFontSize | 2 | El tamaño de fuente por defecto para texto normal. |
QWebEngineSettings::DefaultFixedFontSize | 3 | El tamaño de fuente por defecto para texto de paso fijo. |
[since Qt 6.8] enum class QWebEngineSettings::ImageAnimationPolicy
Este enum describe cómo debe manejarse una animación de imagen cuando los fotogramas de la imagen se renderizan para la animación.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineSettings::ImageAnimationPolicy::Allow | 1 | Permite la animación de la imagen cuando se renderizan los cuadros de imagen. |
QWebEngineSettings::ImageAnimationPolicy::AnimateOnce | 2 | Anima la imagen una vez cuando los cuadros de imagen son renderizados. |
QWebEngineSettings::ImageAnimationPolicy::Disallow | 3 | Desactiva la animación de la imagen cuando los cuadros de imagen son renderizados. |
Este enum se introdujo en Qt 6.8.
Ver también imageAnimationPolicy, setImageAnimationPolicy, y resetImageAnimationPolicy.
[since Qt 5.11] enum QWebEngineSettings::UnknownUrlSchemePolicy
Este enum describe cómo se gestionan las peticiones de navegación a URLs con esquemas desconocidos.
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineSettings::DisallowUnknownUrlSchemes | 1 | Deshabilita todas las peticiones de navegación a URLs con esquemas desconocidos. |
QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction | 2 | Permite las peticiones de navegación a URLs con esquemas desconocidos que se emiten desde la interacción del usuario (como un clic de ratón), mientras que otras peticiones de navegación (por ejemplo desde JavaScript) se suprimen. |
QWebEngineSettings::AllowAllUnknownUrlSchemes | 3 | Permite todas las peticiones de navegación a URLs con esquemas desconocidos. |
Este enum se introdujo en Qt 5.11.
Véase también unknownUrlSchemePolicy, setUnknownUrlSchemePolicy, y resetUnknownUrlSchemePolicy.
enum QWebEngineSettings::WebAttribute
Este tipo de enum especifica la configuración de las páginas web:
| Constante | Valor | Descripción |
|---|---|---|
QWebEngineSettings::AutoLoadImages | 0 | Descarga automática de imágenes para páginas web. Cuando esta opción está desactivada, las imágenes se cargan desde la caché. Activado por defecto. |
QWebEngineSettings::JavascriptEnabled | 1 | Permite la ejecución de programas JavaScript en MainWorld. Activado por defecto. |
QWebEngineSettings::JavascriptCanOpenWindows | 2 | Permite que los programas JavaScript abran ventanas emergentes sin interacción del usuario. Activado por defecto. |
QWebEngineSettings::JavascriptCanAccessClipboard | 3 | Permite que los programas JavaScript escriban (copien) contenido desinfectado en el portapapeles. Una escritura desinfectada se realiza con las llamadas a la API JavaScript Clipboard de write y writeText y debe ir acompañada de una acción del usuario. Las escrituras no desinfectadas y la lectura del portapapeles se activan mediante JavascriptCanPaste. Antes de la versión 81 de Chromium, esta configuración habilitaba todas las escrituras en el portapapeles. Dado que el acceso no restringido al portapapeles es un posible problema de seguridad, se recomienda que las aplicaciones lo dejen desactivado y respondan a las solicitudes de permiso de la función ClipboardReadWrite. Desactivado por defecto. |
QWebEngineSettings::LinksIncludedInFocusChain | 4 | Incluye hipervínculos en la cadena de enfoque del teclado. Activado por defecto. |
QWebEngineSettings::LocalStorageEnabled | 5 | Habilita la compatibilidad con la función de almacenamiento local de HTML 5. Activado por defecto. |
QWebEngineSettings::LocalContentCanAccessRemoteUrls | 6 | Permite a los documentos de origen local acceder a recursos remotos que normalmente estarían bloqueados. Desactivado por defecto. Nota: DnsPrefetchEnabled funciona independientemente de esta opción y, si está activada, puede provocar accesos remotos desde contenido local. |
QWebEngineSettings::XSSAuditingEnabled | 7 | Obsoleto y sin efecto. |
QWebEngineSettings::SpatialNavigationEnabled | 8 | Activa la función de Navegación Espacial, es decir, la posibilidad de navegar entre elementos enfocables, como hipervínculos y controles de formularios, en una página web utilizando las teclas de flecha izquierda, derecha, arriba y abajo. Por ejemplo, si un usuario pulsa la tecla Derecha, la heurística determina si hay un elemento que podría estar intentando alcanzar hacia la derecha y cuál es el elemento que probablemente desea. Desactivado por defecto. |
QWebEngineSettings::LocalContentCanAccessFileUrls | 9 | Permite que los documentos cargados localmente accedan a otras URL locales. Deshabilitar esto hace que QtWebEngine se comporte más como lo hacen Chrome y Firefox por defecto. Activado por defecto. |
QWebEngineSettings::HyperlinkAuditingEnabled | 10 | Habilita el soporte del atributo ping para hipervínculos. Desactivado por defecto. |
QWebEngineSettings::ScrollAnimatorEnabled | 11 | Activa el desplazamiento animado. Desactivado por defecto. |
QWebEngineSettings::ErrorPageEnabled | 12 | Activa la visualización de las páginas de error integradas en Chromium. Activado por defecto. |
QWebEngineSettings::PluginsEnabled (since Qt 5.6) | 13 | Habilita el soporte para plugins de Pepper, como Flash player. Desactivado por defecto. |
QWebEngineSettings::FullScreenSupportEnabled (since Qt 5.6) | 14 | Habilita el soporte de pantalla completa en una aplicación. Desactivado por defecto. |
QWebEngineSettings::ScreenCaptureEnabled (since Qt 5.7) | 15 | Activa la captura de pantalla en una aplicación. Desactivado por defecto. |
QWebEngineSettings::WebGLEnabled (since Qt 5.7) | 16 | Activa la compatibilidad con HTML 5 WebGL. Activado por defecto si está disponible. |
QWebEngineSettings::Accelerated2dCanvasEnabled (since Qt 5.7) | 17 | Especifica si el lienzo 2D de HTML5 debe ser un framebuffer OpenGL. Esto hace que muchas operaciones de pintura sean más rápidas, pero ralentiza el acceso a los píxeles. Activado por defecto si está disponible. |
QWebEngineSettings::AutoLoadIconsForPage (since Qt 5.7) | 18 | Descarga automática de iconos para páginas web. Activado por defecto. |
QWebEngineSettings::TouchIconsEnabled (since Qt 5.7) | 19 | Habilita el soporte para iconos táctiles e iconos táctiles precompuestos Deshabilitado por defecto. |
QWebEngineSettings::FocusOnNavigationEnabled (since Qt 5.8) | 20 | Da foco a la vista asociada a la página, siempre que se produzca una operación de navegación (cargar, detener, recargar, recargar y omitir caché, avanzar, retroceder, establecer contenido, etc.). Desactivado por defecto. |
QWebEngineSettings::PrintElementBackgrounds (since Qt 5.8) | 21 | Activa la impresión de los fondos CSS al imprimir una página web. Activado por defecto. |
QWebEngineSettings::AllowRunningInsecureContent (since Qt 5.8) | 22 | Por defecto, las páginas HTTPS no pueden ejecutar JavaScript, CSS, plugins o web-sockets desde URLs HTTP. Esto proporciona una anulación para obtener el antiguo comportamiento inseguro. Desactivado por defecto. |
QWebEngineSettings::AllowGeolocationOnInsecureOrigins (since Qt 5.9) | 23 | Sólo los orígenes seguros como HTTPS pueden solicitar funciones de Geolocalización. Esta opción permite a los orígenes no seguros acceder a la geolocalización. Desactivado por defecto. |
QWebEngineSettings::AllowWindowActivationFromJavaScript (since Qt 5.10) | 24 | Permite activar ventanas utilizando el método JavaScript window.focus(). Desactivado por defecto. |
QWebEngineSettings::ShowScrollBars (since Qt 5.10) | 25 | Muestra barras de desplazamiento. Activado por defecto. |
QWebEngineSettings::PlaybackRequiresUserGesture (since Qt 5.11) | 26 | Inhibe la reproducción de contenido multimedia hasta que el usuario interactúa con la página. Por defecto, WebEngine utiliza la configuración de Chromium, como se describe en Cambios en la política de reproducción automática. Esto es similar a cómo se comporta Chrome en Android, mientras que el comportamiento por defecto cuando está desactivado es similar a Chrome en ordenadores de sobremesa. Para sobrescribir el comportamiento predeterminado, deshabilite esta configuración. |
QWebEngineSettings::JavascriptCanPaste (since Qt 5.11) | 28 | Habilita JavaScript execCommand("paste"). Esto también requiere habilitar JavascriptCanAccessClipboard. Dado que el acceso ilimitado al portapapeles es un posible problema de seguridad, se recomienda que las aplicaciones dejen esta opción desactivada y, en su lugar, respondan a las solicitudes de permiso de la función ClipboardReadWrite. Desactivado por defecto. |
QWebEngineSettings::WebRTCPublicInterfacesOnly (since Qt 5.11) | 27 | Limita WebRTC sólo a direcciones IP públicas. Cuando está desactivado, WebRTC también puede utilizar direcciones IP de red local, pero los hosts remotos también pueden ver su dirección IP de red local. Desactivado por defecto. |
QWebEngineSettings::DnsPrefetchEnabled (since Qt 5.12) | 29 | Especifica si WebEngine intentará obtener previamente entradas DNS para acelerar la navegación. Desactivado por defecto. |
QWebEngineSettings::PdfViewerEnabled (since Qt 5.13) | 30 | Especifica que los documentos PDF se abran en el visor de PDF interno en lugar de descargarse. Activado por defecto. |
QWebEngineSettings::NavigateOnDropEnabled (since Qt 6.4) | 31 | Especifica que las navegaciones pueden activarse soltando URL en la vista. Activado por defecto. |
QWebEngineSettings::ReadingFromCanvasEnabled (since Qt 6.6) | 32 | Especifica que está habilitada la lectura de todos los elementos del lienzo. Esta configuración afectará a todos los elementos canvas de HTML5, independientemente de su origen, y puede desactivarse para evitar el canvas fingerprinting. Activado por defecto. |
QWebEngineSettings::ForceDarkMode (since Qt 6.7) | 33 | Especifica que todos los contenidos web se renderizarán utilizando un tema oscuro. Para obtener más información, consulte Tema oscuro automático. Desactivado por defecto. |
QWebEngineSettings::PrintHeaderAndFooter (since Qt 6.9) | 34 | Especifica que los resultados de impresión contendrán la información básica de la página (URL, título, fecha, número de página) en el área de encabezado y pie de página. Es responsabilidad del incrustador proporcionar espacio suficiente para estos textos estableciendo los márgenes superior e inferior adecuados. Desactivado por defecto. |
QWebEngineSettings::PreferCSSMarginsForPrinting (since Qt 6.9) | 35 | Activa la preferencia de los márgenes CSS sobre los márgenes del sitio QPageLayout especificado. Desactivado por defecto. |
QWebEngineSettings::TouchEventsApiEnabled (since Qt 6.9) | 36 | Activa la compatibilidad con la API de eventos táctiles de JavaScript, lo que significa que los manejadores de ontouchstart, ontouchend y ontouchmove estarán presentes en el objeto document.window. Habilitado por defecto si el sistema detecta un dispositivo táctil y deshabilitado en caso contrario. Tenga en cuenta que algunos sitios web utilizan esta API para decidir si se ejecutan en un dispositivo móvil o en un ordenador de sobremesa y basan su diseño en ella. Esto puede causar resultados no deseados en portátiles con pantalla táctil u otras configuraciones que emulen un dispositivo táctil falso. |
QWebEngineSettings::BackForwardCacheEnabled (since Qt 6.10) | 37 | Activa la compatibilidad con la caché de retroceso/avance (o bfcache) para acelerar la navegación de retroceso y avance. Desactivado por defecto. |
QWebEngineSettings::TrimAccessibilityIdentifiers (since Qt 6.11) | 38 | Fuerza al atributo HTML 'id' a ser usado como el ID de automatización (QAccessible::Identifier) sin modificación. Cuando se desactiva, Qt antepondrá en su lugar toda la jerarquía de objetos al identificador. Deshabilitado por defecto. |
Documentación de las funciones miembro
QString QWebEngineSettings::defaultTextEncoding() const
Devuelve la codificación de texto por defecto.
Véase también setDefaultTextEncoding().
QString QWebEngineSettings::fontFamily(QWebEngineSettings::FontFamily which) const
Devuelve la familia de fuentes real para la familia de fuentes genérica especificada, which.
int QWebEngineSettings::fontSize(QWebEngineSettings::FontSize type) const
Devuelve el tamaño de fuente predeterminado para type en píxeles.
Véase también setFontSize().
[since Qt 6.8] QWebEngineSettings::ImageAnimationPolicy QWebEngineSettings::imageAnimationPolicy() const
Devuelve la política seleccionada actualmente para manejar la animación de la imagen cuando se renderizan los fotogramas de la imagen. Por defecto es QWebEngineSettings::ImageAnimationPolicy::Allow.
Esta función se introdujo en Qt 6.8.
Véase también setImageAnimationPolicy y resetImageAnimationPolicy.
void QWebEngineSettings::resetAttribute(QWebEngineSettings::WebAttribute attribute)
Restablece la configuración de attribute al valor especificado en el perfil al que pertenece la página.
void QWebEngineSettings::resetFontFamily(QWebEngineSettings::FontFamily which)
Restablece la familia de fuentes real especificada por which a la especificada en el perfil al que pertenece la página.
void QWebEngineSettings::resetFontSize(QWebEngineSettings::FontSize type)
Restablece el tamaño de fuente de type al tamaño especificado en el perfil al que pertenece la página.
[since Qt 6.8] void QWebEngineSettings::resetImageAnimationPolicy()
Elimina la política de manejo de animación de imágenes.
Esta función se introdujo en Qt 6.8.
Véase también imageAnimationPolicy y setImageAnimationPolicy.
[since Qt 5.11] void QWebEngineSettings::resetUnknownUrlSchemePolicy()
Elimina la política de manejo de peticiones de navegación a URLs con esquemas desconocidos.
Esta función se introdujo en Qt 5.11.
Véase también unknownUrlSchemePolicy y setUnknownUrlSchemePolicy.
void QWebEngineSettings::setAttribute(QWebEngineSettings::WebAttribute attribute, bool on)
Activa o desactiva la función attribute especificada en función del valor de on.
void QWebEngineSettings::setDefaultTextEncoding(const QString &encoding)
Especifica el sistema de codificación de texto por defecto.
El valor de encoding debe ser una cadena que describa una codificación como "utf-8" o "iso-8859-1". Si se deja vacío, se utilizará un valor por defecto. Para obtener una lista más amplia de nombres de codificación, consulte QTextCodec.
Véase también defaultTextEncoding().
void QWebEngineSettings::setFontSize(QWebEngineSettings::FontSize type, int size)
Establece el tamaño de la fuente de type a size en píxeles.
Véase también fontSize().
[since Qt 6.8] void QWebEngineSettings::setImageAnimationPolicy(QWebEngineSettings::ImageAnimationPolicy policy)
Establece la política para manejar la animación de la imagen cuando los fotogramas de la imagen se renderizan en policy. Por defecto es QWebEngineSettings::ImageAnimationPolicy::Allow.
Esta función se introdujo en Qt 6.8.
Véase también imageAnimationPolicy y resetImageAnimationPolicy.
[since Qt 5.11] void QWebEngineSettings::setUnknownUrlSchemePolicy(QWebEngineSettings::UnknownUrlSchemePolicy policy)
Establece la política de tratamiento de las peticiones de navegación a URL con esquemas desconocidos en policy. Por defecto es QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.
Esta función se introdujo en Qt 5.11.
Véase también unknownUrlSchemePolicy y resetUnknownUrlSchemePolicy.
bool QWebEngineSettings::testAttribute(QWebEngineSettings::WebAttribute attribute) const
Devuelve true si attribute está activado; en caso contrario devuelve false.
[since Qt 5.11] QWebEngineSettings::UnknownUrlSchemePolicy QWebEngineSettings::unknownUrlSchemePolicy() const
Devuelve la política seleccionada actualmente para gestionar las peticiones de navegación a URLs con esquemas desconocidos. Por defecto es QWebEngineSettings::AllowUnknownUrlSchemesFromUserInteraction.
Esta función se introdujo en Qt 5.11.
Véase también setUnknownUrlSchemePolicy y 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.
