En esta página

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)

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.