QStyleHints Class
La clase QStyleHints contiene indicaciones y configuraciones específicas de cada plataforma. Más información...
| Encabezado: | #include <QStyleHints> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QObject |
Propiedades
Funciones públicas
| const QAccessibilityHints * | accessibility() const |
| Qt::ColorScheme | colorScheme() const |
| Qt::ContextMenuTrigger | contextMenuTrigger() const |
| int | cursorFlashTime() const |
| qreal | fontSmoothingGamma() const |
| qreal | keyboardAutoRepeatRateF() const |
| int | keyboardInputInterval() const |
| bool | menuSelectionWraps() const |
| int | mouseDoubleClickDistance() const |
| int | mouseDoubleClickInterval() const |
| int | mousePressAndHoldInterval() const |
| int | mouseQuickSelectionThreshold() const |
| QChar | passwordMaskCharacter() const |
| int | passwordMaskDelay() const |
(since 6.8) void | setColorScheme(Qt::ColorScheme scheme) |
| void | setContextMenuTrigger(Qt::ContextMenuTrigger contextMenuTrigger) |
| bool | setFocusOnTouchRelease() const |
| void | setShowShortcutsInContextMenus(bool showShortcutsInContextMenus) |
| void | setToolTipWakeUpDelay(std::chrono::milliseconds toolTipWakeUpDelay) |
| void | setUseHoverEffects(bool useHoverEffects) |
| bool | showIsFullScreen() const |
| bool | showIsMaximized() const |
| bool | showShortcutsInContextMenus() const |
| bool | singleClickActivation() const |
| int | startDragDistance() const |
| int | startDragTime() const |
| int | startDragVelocity() const |
| Qt::TabFocusBehavior | tabFocusBehavior() const |
| std::chrono::milliseconds | toolTipWakeUpDelay() const |
| int | toolTipWakeUpDelayAsMSec() const |
| int | touchDoubleTapDistance() const |
(since 6.8) void | unsetColorScheme() |
| bool | useHoverEffects() const |
| bool | useRtlExtensions() const |
| int | wheelScrollLines() const |
Señales
| void | colorSchemeChanged(Qt::ColorScheme colorScheme) |
| void | contextMenuTriggerChanged(Qt::ContextMenuTrigger contextMenuTrigger) |
| void | cursorFlashTimeChanged(int cursorFlashTime) |
| void | keyboardInputIntervalChanged(int keyboardInputInterval) |
| void | mouseDoubleClickIntervalChanged(int mouseDoubleClickInterval) |
| void | mousePressAndHoldIntervalChanged(int mousePressAndHoldInterval) |
| void | mouseQuickSelectionThresholdChanged(int threshold) |
| void | showShortcutsInContextMenusChanged(bool) |
| void | startDragDistanceChanged(int startDragDistance) |
| void | startDragTimeChanged(int startDragTime) |
| void | tabFocusBehaviorChanged(Qt::TabFocusBehavior tabFocusBehavior) |
| void | toolTipWakeUpDelayAsMSecChanged(int toolTipWakeUpDelay) |
| void | toolTipWakeUpDelayChanged(std::chrono::milliseconds toolTipWakeUpDelay) |
| void | useHoverEffectsChanged(bool useHoverEffects) |
| void | wheelScrollLinesChanged(int scrollLines) |
Descripción detallada
Un objeto de esta clase, obtenido mediante ` QGuiApplication`, permite acceder a determinados parámetros globales de la interfaz de usuario de la plataforma actual.
La plataforma proporciona la mayoría de estos ajustes, que suelen ser de solo lectura. Los usuarios finales suelen poder ajustarlos mediante mecanismos de configuración específicos de la plataforma. Sin embargo, también se pueden ajustar algunos parámetros mediante programación a través de funciones de configuración específicas (por ejemplo, ` setColorScheme()` o ` setShowShortcutsInContextMenus()`), lo cual puede resultar útil para realizar pruebas o para un comportamiento especializado de la aplicación. Cualquier ajuste de este tipo se aplica únicamente a la aplicación actual.
Los autores de componentes de interfaz de usuario personalizados deben leer los ajustes pertinentes para que los componentes muestren el mismo comportamiento y la misma experiencia de usuario que los demás componentes.
Véase también QGuiApplication::styleHints().
Documentación de propiedades
[read-only, since 6.10] accessibility : const QAccessibilityHints*
Esta propiedad contiene las sugerencias de accesibilidad de la aplicación.
Las sugerencias de accesibilidad encapsulan ajustes de accesibilidad dependientes de la plataforma, como por ejemplo si el usuario desea que la aplicación se muestre en modo de alto contraste o no.
Esta enumeración se introdujo en Qt 6.10.
Funciones de acceso:
| const QAccessibilityHints * | accessibility() const |
Véase también QAccessibilityHints.
[since 6.5] colorScheme : Qt::ColorScheme
Esta propiedad contiene la combinación de colores que utiliza la aplicación.
Por defecto, sigue la combinación de colores predeterminada del sistema (también conocida como «apariencia») y cambia cuando cambia la combinación de colores del sistema (por ejemplo, al atardecer o al amanecer). Establecer la combinación de colores en un valor explícito anulará la configuración del sistema e ignorará cualquier cambio en la combinación de colores del sistema. Sin embargo, hacerlo supone una sugerencia al sistema, y la anulación de la combinación de colores no es compatible con todas las plataformas.
Si se restablece esta propiedad o se establece en ` Qt::ColorScheme::Unknown`, se eliminará la anulación y la aplicación volverá a seguir la configuración predeterminada del sistema. El valor de la propiedad cambiará al esquema de colores que tenga el sistema en ese momento.
Cuando esta propiedad cambia, Qt leerá la paleta del sistema y actualizará la paleta predeterminada, pero no sobrescribirá las entradas de la paleta que hayan sido establecidas explícitamente por la aplicación. Cuando se emite la señal colorSchemeChange(), la paleta anterior sigue vigente.
Los colores específicos de la aplicación deben seleccionarse de modo que funcionen bien con la paleta vigente, teniendo en cuenta el esquema de colores actual. Para actualizar los colores específicos de la aplicación cuando cambie la paleta vigente, gestiona los eventos PaletteChange o ApplicationPaletteChange.
Esta enumeración se introdujo en Qt 6.5.
Funciones de acceso:
| Qt::ColorScheme | colorScheme() const |
| void | setColorScheme(Qt::ColorScheme scheme) |
| void | unsetColorScheme() |
Señal Notifier:
| void | colorSchemeChanged(Qt::ColorScheme colorScheme) |
Véase también Qt::ColorScheme, QGuiApplication::palette() y QEvent::PaletteChange.
[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger
Evento del ratón utilizado para activar un evento del menú contextual.
El comportamiento predeterminado en los sistemas UNIX es mostrar el menú contextual al pulsar el botón del ratón, mientras que en Windows es al soltar el botón del ratón. Esta propiedad se puede utilizar para anular el comportamiento predeterminado de la plataforma.
Nota: Los desarrolladores deben utilizar esta propiedad con mucho cuidado, ya que modifica el modo de interacción predeterminado que esperan los usuarios en la plataforma en la que se ejecuta la aplicación.
Esta enumeración se introdujo en Qt 6.8.
Funciones de acceso:
| Qt::ContextMenuTrigger | contextMenuTrigger() const |
| void | setContextMenuTrigger(Qt::ContextMenuTrigger contextMenuTrigger) |
Señal de notificador:
| void | contextMenuTriggerChanged(Qt::ContextMenuTrigger contextMenuTrigger) |
Véase también Qt::ContextMenuTrigger.
[read-only] cursorFlashTime : int
Esta propiedad almacena el tiempo de parpadeo del cursor de texto en milisegundos.
El tiempo de parpadeo es el tiempo que se tarda en mostrar, invertir y restablecer la visualización del cursor de texto. Normalmente, el cursor de texto se muestra durante la mitad del tiempo de parpadeo y, a continuación, se oculta durante el mismo tiempo.
Funciones de acceso:
| int | cursorFlashTime() const |
Señal de notificación:
| void | cursorFlashTimeChanged(int cursorFlashTime) |
[read-only] fontSmoothingGamma : const qreal
Esta propiedad contiene el valor gamma utilizado en el suavizado de fuentes.
Funciones de acceso:
| qreal | fontSmoothingGamma() const |
[read-only, since 6.5] keyboardAutoRepeatRateF : const qreal
Esta propiedad indica la frecuencia, en eventos por segundo, a la que se generarán automáticamente pulsaciones repetidas adicionales de una tecla si esta se mantiene pulsada.
Esta enumeración se introdujo en Qt 6.5.
Funciones de acceso:
| qreal | keyboardAutoRepeatRateF() const |
[read-only] keyboardInputInterval : int
Esta propiedad indica el intervalo de tiempo, en milisegundos, que distingue una pulsación de tecla de dos pulsaciones consecutivas.
Funciones de acceso:
| int | keyboardInputInterval() const |
Señal de notificación:
| void | keyboardInputIntervalChanged(int keyboardInputInterval) |
[read-only, since 6.10] menuSelectionWraps : const bool
La selección del menú vuelve al principio.
Devuelve « true » si la selección del menú se reanuda. Es decir, si la navegación mediante teclas lleva la selección de nuevo al primer elemento del menú tras haber llegado al último, y viceversa.
Esta enumeración se introdujo en Qt 6.10.
Funciones de acceso:
| bool | menuSelectionWraps() const |
[read-only] mouseDoubleClickDistance : const int
Esta propiedad indica la distancia máxima, en píxeles, a la que se puede mover el ratón entre dos clics consecutivos para que se detecte como un doble clic
Funciones de acceso:
| int | mouseDoubleClickDistance() const |
[read-only] mouseDoubleClickInterval : int
Esta propiedad establece el intervalo de tiempo, en milisegundos, que distingue un doble clic de dos clics consecutivos del ratón.
Funciones de acceso:
| int | mouseDoubleClickInterval() const |
Señal de notificación:
| void | mouseDoubleClickIntervalChanged(int mouseDoubleClickInterval) |
[read-only] mousePressAndHoldInterval : int
Esta propiedad establece el tiempo, en milisegundos, tras el cual se activa la acción de «mantener pulsado».
Funciones de acceso:
| int | mousePressAndHoldInterval() const |
Señal de notificación:
| void | mousePressAndHoldIntervalChanged(int mousePressAndHoldInterval) |
mouseQuickSelectionThreshold : int
Umbral del ratón para la selección rápida en QLineEdit.
Esta propiedad define cuánto debe desplazarse el cursor del ratón a lo largo del eje y para activar la selección rápida durante una selección de texto normal en QLineEdit.
Si el valor de la propiedad es menor o igual que 0, la función de selección rápida queda desactivada.
Funciones de acceso:
| int | mouseQuickSelectionThreshold() const |
Señal de notificación:
| void | mouseQuickSelectionThresholdChanged(int threshold) |
[read-only] passwordMaskCharacter : const QChar
Esta propiedad contiene el carácter que se utiliza para ocultar los caracteres introducidos en los campos de texto en modo contraseña.
Funciones de acceso:
| QChar | passwordMaskCharacter() const |
[read-only] passwordMaskDelay : const int
Esta propiedad indica el tiempo, en milisegundos, durante el que una letra tecleada permanece visible en un campo de introducción de texto en modo contraseña.
Funciones de acceso:
| int | passwordMaskDelay() const |
[read-only] setFocusOnTouchRelease : const bool
Esta propiedad contiene el evento que debe establecer el foco de entrada en los objetos de foco.
Esta propiedad tiene el valor « true » si los objetos de foco (campos de edición de línea, etc.) deben recibir el foco de entrada tras soltar el tacto o el ratón. Este es el comportamiento habitual en plataformas táctiles. En plataformas de escritorio, lo habitual es establecer el foco al pulsar el tacto o el ratón.
Funciones de acceso:
| bool | setFocusOnTouchRelease() const |
[read-only] showIsFullScreen : const bool
Esta propiedad indica si la plataforma establece por defecto las ventanas en modo de pantalla completa.
Esta propiedad tiene el valor « true » si la plataforma establece por defecto que las ventanas se muestren a pantalla completa; en caso contrario, tiene el valor « false ».
Nota: La plataforma puede optar por mostrar ciertas ventanas sin pantalla completa, como ventanas emergentes o cuadros de diálogo. Esta propiedad solo indica el comportamiento predeterminado.
Funciones de acceso:
| bool | showIsFullScreen() const |
Véanse también QWindow::show() y showIsMaximized().
[read-only] showIsMaximized : const bool
Esta propiedad indica si la plataforma muestra por defecto las ventanas maximizadas.
Esta propiedad es « true » si la plataforma muestra por defecto las ventanas maximizadas; en caso contrario, es « false ».
Nota: La plataforma puede optar por mostrar determinadas ventanas sin maximizar, como ventanas emergentes o cuadros de diálogo. Esta propiedad solo indica el comportamiento predeterminado.
Funciones de acceso:
| bool | showIsMaximized() const |
Véanse también ` QWindow::show()` y ` showIsFullScreen()`.
showShortcutsInContextMenus : bool
true si la plataforma muestra normalmente las secuencias de teclas de acceso rápido en los menús contextuales; en caso contrario, false.
Desde Qt 5.13, se puede utilizar la función setShowShortcutsInContextMenus() para anular la configuración predeterminada de la plataforma.
Funciones de acceso:
| bool | showShortcutsInContextMenus() const |
| void | setShowShortcutsInContextMenus(bool showShortcutsInContextMenus) |
Señal Notifier:
| void | showShortcutsInContextMenusChanged(bool) |
Véase también Qt::AA_DontShowShortcutsInContextMenus.
[read-only] singleClickActivation : const bool
Esta propiedad determina si los elementos se activan con un clic simple o con un doble clic.
Esta propiedad es « true » si los elementos deben activarse con un clic simple, y « false » si, por el contrario, deben activarse con un doble clic.
Funciones de acceso:
| bool | singleClickActivation() const |
[read-only] startDragDistance : int
Esta propiedad indica la distancia, en píxeles, que debe desplazarse el ratón con un botón pulsado antes de que comience una operación de arrastrar y soltar.
Si tu aplicación admite la función de arrastrar y soltar y deseas iniciar una operación de arrastrar y soltar después de que el usuario haya movido el cursor una distancia determinada con un botón pulsado, debes utilizar el valor de esta propiedad como la distancia mínima requerida.
Por ejemplo, si la posición del ratón en el momento del clic se almacena en startPos y la posición actual (por ejemplo, en el evento de movimiento del ratón) es currentPos, puedes determinar si debe iniciarse un arrastre con un código como este:
if ((startPos - currentPos).manhattanLength() >=
QApplication::startDragDistance())
startTheDrag();Funciones de acceso:
| int | startDragDistance() const |
Señal de notificación:
| void | startDragDistanceChanged(int startDragDistance) |
Véase también startDragTime, QPoint::manhattanLength() y Arrastrar y soltar.
[read-only] startDragTime : int
Esta propiedad indica el tiempo, en milisegundos, que debe mantenerse pulsado un botón del ratón antes de que comience una operación de arrastrar y soltar.
Si tu aplicación admite la función de arrastrar y soltar, y deseas iniciar una operación de arrastrar y soltar después de que el usuario haya mantenido pulsado un botón del ratón durante un tiempo determinado, debes utilizar el valor de esta propiedad como retardo.
Funciones de acceso:
| int | startDragTime() const |
Señal de notificador:
| void | startDragTimeChanged(int startDragTime) |
Véase también « startDragDistance » y «Arrastrar y soltar».
[read-only] startDragVelocity : const int
Esta propiedad establece el límite de velocidad, en píxeles por segundo, al que se puede mover el ratón —con un botón pulsado— para que se inicie una operación de arrastrar y soltar. Un valor de 0 significa que no existe dicho límite.
Funciones de acceso:
| int | startDragVelocity() const |
Véase también « startDragDistance » y «Arrastrar y soltar».
[read-only] tabFocusBehavior : Qt::TabFocusBehavior
Esta propiedad controla el comportamiento del foco al pulsar la tecla Tab.
Nota: No asigne este valor en QML, ya que la señal de notificación de cambios aún no está implementada.
Funciones de acceso:
| Qt::TabFocusBehavior | tabFocusBehavior() const |
Señal de notificador:
| void | tabFocusBehaviorChanged(Qt::TabFocusBehavior tabFocusBehavior) |
[since 6.12] toolTipWakeUpDelay : std::chrono::milliseconds
Esta propiedad define el retraso tras el cual deben mostrarse las descripciones emergentes.
Esta enumeración se introdujo en Qt 6.12.
Funciones de acceso:
| std::chrono::milliseconds | toolTipWakeUpDelay() const |
| void | setToolTipWakeUpDelay(std::chrono::milliseconds toolTipWakeUpDelay) |
Señal del notificador:
| void | toolTipWakeUpDelayChanged(std::chrono::milliseconds toolTipWakeUpDelay) |
Véase también QWidget::toolTip y QtQuick.Controls::ToolTip::delay.
[read-only, since 6.12] toolTipWakeUpDelayAsMSec : int
Esta propiedad establece el retraso, en milisegundos, antes de que se muestren las descripciones emergentes.
Esta enumeración se introdujo en Qt 6.12.
Funciones de acceso:
| int | toolTipWakeUpDelayAsMSec() const |
Señal de notificador:
| void | toolTipWakeUpDelayAsMSecChanged(int toolTipWakeUpDelay) |
Véase también toolTipWakeUpDelay y QtQuick.Controls::ToolTip::delay.
[read-only] touchDoubleTapDistance : const int
Esta propiedad indica la distancia máxima, en píxeles, que puede desplazarse un dedo entre dos toques consecutivos para que se siga detectando como un doble toque
Funciones de acceso:
| int | touchDoubleTapDistance() const |
useHoverEffects : bool
Esta propiedad determina si los elementos de la interfaz de usuario utilizan efectos al pasar el cursor por encima.
Esta propiedad tiene el valor « true » si los elementos de la interfaz de usuario deben utilizar efectos al pasar el cursor. Este es el comportamiento estándar en plataformas de escritorio con puntero de ratón, mientras que en plataformas táctiles se puede evitar la sobrecarga que supone la gestión de eventos al pasar el cursor.
Funciones de acceso:
| bool | useHoverEffects() const |
| void | setUseHoverEffects(bool useHoverEffects) |
Señal de notificador:
| void | useHoverEffectsChanged(bool useHoverEffects) |
[read-only] useRtlExtensions : const bool
Esta propiedad almacena la dirección de escritura.
Esta propiedad es « true » si está habilitada la dirección de escritura de derecha a izquierda; en caso contrario, es « false ».
Funciones de acceso:
| bool | useRtlExtensions() const |
[read-only] wheelScrollLines : int
Número de líneas que se desplazan por defecto con cada clic de la rueda.
Funciones de acceso:
| int | wheelScrollLines() const |
Señal del notificador:
| void | wheelScrollLinesChanged(int scrollLines) |
Documentación de funciones de miembro
[since 6.8] void QStyleHints::setColorScheme(Qt::ColorScheme scheme)
Establece la combinación de colores que utiliza la aplicación en un valor explícito de ` scheme`; si ` scheme ` es ` Qt::ColorScheme::Unknown`, se vuelve a la combinación de colores actual del sistema.
Nota: Funciónde configuración para la propiedad ` colorScheme`.
Esta función se introdujo en Qt 6.8.
Véase también colorScheme().
[since 6.8] void QStyleHints::unsetColorScheme()
Restablece la combinación de colores a la combinación actual del sistema.
Nota: Funciónde restablecimiento para la propiedad « colorScheme ».
Esta función se introdujo en Qt 6.8.
© 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.