QStyleHints Class

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 si el usuario desea que la aplicación tenga alto contraste o no.

Esta propiedad se introdujo en Qt 6.10.

Funciones de acceso:

Véase también QAccessibilityHints.

[since 6.5] colorScheme : Qt::ColorScheme

Esta propiedad contiene el esquema de color utilizado por la aplicación.

Por defecto, sigue el esquema de color predeterminado del sistema (también conocido como apariencia), y cambia cuando cambia el esquema de color del sistema (por ejemplo, al anochecer o al amanecer). Establecer el esquema de color a un valor explícito anulará la configuración del sistema e ignorará cualquier cambio en el esquema de color del sistema. Sin embargo, hacer esto es una sugerencia al sistema, y anular el esquema de color no está soportado en todas las plataformas.

Restablecer esta propiedad, o establecerla en Qt::ColorScheme::Unknown, eliminará la anulación y hará que la aplicación siga de nuevo la configuración predeterminada del sistema. El valor de la propiedad cambiará al esquema de color que tenga actualmente el sistema.

Cuando esta propiedad cambie, Qt leerá la paleta del sistema y actualizará la paleta por defecto, pero no sobrescribirá las entradas de paleta que hayan sido explícitamente establecidas por la aplicación. Cuando se emite la señal colorSchemeChange(), la paleta antigua sigue vigente.

Los colores específicos de la aplicación deben seleccionarse para que funcionen bien con la paleta efectiva, teniendo en cuenta el esquema de color actual. Para actualizar los colores específicos de la aplicación cuando cambia la paleta efectiva, gestiona los eventos PaletteChange o ApplicationPaletteChange.

Esta propiedad se introdujo en Qt 6.5.

Funciones de acceso:

Señal de notificador:

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 de menú contextual.

El comportamiento por defecto en sistemas UNIX es mostrar el menú contextual en el evento de pulsación del botón del ratón, mientras que en Windows es el evento de liberación del botón del ratón. Esta propiedad puede utilizarse para anular el comportamiento por defecto de la plataforma.

Esta propiedad se introdujo en Qt 6.8.

Funciones de acceso:

Señal de notificador:

Véase también Qt::ContextMenuTrigger.

[read-only] cursorFlashTime : int

Esta propiedad contiene el tiempo de parpadeo del cursor de texto en milisegundos.

El tiempo de parpadeo es el tiempo utilizado para mostrar, invertir y restaurar la visualización del cursor. Normalmente el cursor de texto se muestra durante la mitad del tiempo de parpadeo del cursor, y luego se oculta durante el mismo tiempo.

Funciones de acceso:

Señal de aviso:

[read-only] fontSmoothingGamma : const qreal

Esta propiedad contiene el valor gamma utilizado en el suavizado de fuentes.

Funciones de acceso:

[read-only, since 6.5] keyboardAutoRepeatRateF : const qreal

Esta propiedad mantiene la tasa, en eventos por segundo, en la que se generarán automáticamente pulsaciones repetidas adicionales si se mantiene pulsada una tecla.

Esta propiedad se introdujo en Qt 6.5.

Funciones de acceso:

[read-only] keyboardInputInterval : int

Esta propiedad contiene el límite de tiempo, en milisegundos, que distingue una pulsación de tecla de dos pulsaciones consecutivas.

Funciones de acceso:

Señal del notificador:

[read-only, since 6.10] menuSelectionWraps : const bool

la selección del menú se envuelve.

Devuelve true si la selección del menú se envuelve. Es decir, si la navegación por teclas mueve la selección al primer elemento del menú de nuevo después de alcanzar el último elemento del menú, y viceversa.

Esta propiedad se introdujo en Qt 6.10.

Funciones de acceso:

[read-only] mouseDoubleClickDistance : const int

Esta propiedad contiene la distancia máxima, en píxeles, a la que se puede mover el ratón entre dos clics consecutivos y seguir detectándolo como un doble clic.

Funciones de acceso:

[read-only] mouseDoubleClickInterval : int

Esta propiedad contiene el límite de tiempo en milisegundos que distingue un doble clic de dos clics consecutivos del ratón.

Funciones de acceso:

Señal del notificador:

[read-only] mousePressAndHoldInterval : int

Esta propiedad contiene el límite de tiempo en milisegundos que activa una pulsación mantenida.

Funciones de acceso:

Señal del notificador:

mouseQuickSelectionThreshold : int

Umbral de selección rápida del ratón en QLineEdit.

Esta propiedad define cuánto debe moverse el cursor del ratón a lo largo del eje y para activar una selección rápida durante una selección de texto normal en QLineEdit.

Si el valor de la propiedad es menor o igual a 0, la función de selección rápida está desactivada.

Funciones de acceso:

Señal del notificador:

[read-only] passwordMaskCharacter : const QChar

Esta propiedad contiene el carácter utilizado para enmascarar los caracteres escritos en los campos de entrada de texto en modo contraseña.

Funciones de acceso:

[read-only] passwordMaskDelay : const int

Esta propiedad contiene el tiempo, en milisegundos, que se muestra una letra tecleada sin ocultar en un campo de entrada de texto en modo contraseña.

Funciones de acceso:

[read-only] setFocusOnTouchRelease : const bool

Esta propiedad contiene el evento que debe establecer el foco de entrada en los objetos de foco.

Esta propiedad es true si los objetos de foco (ediciones de línea, etc) deben recibir el foco de entrada después de un toque/suelte del ratón. Este es el comportamiento normal en plataformas táctiles. En plataformas de escritorio, el estándar es establecer el foco ya al pulsar el ratón.

Funciones de acceso:

[read-only] showIsFullScreen : const bool

Esta propiedad indica si la plataforma utiliza por defecto ventanas a pantalla completa.

Esta propiedad es true si la plataforma muestra por defecto las ventanas a pantalla completa, en caso contrario false.

Funciones de acceso:

Véase también QWindow::show() y showIsMaximized().

[read-only] showIsMaximized : const bool

Esta propiedad indica si la plataforma utiliza por defecto ventanas maximizadas.

Esta propiedad es true si la plataforma muestra por defecto las ventanas maximizadas, en caso contrario false.

Funciones de acceso:

Véase también QWindow::show() y showIsFullScreen().

showShortcutsInContextMenus : bool

true si la plataforma muestra normalmente secuencias de teclas de acceso directo en los menús contextuales, en caso contrario false.

Desde Qt 5.13, la función setShowShortcutsInContextMenus() puede usarse para anular el valor por defecto de la plataforma.

Funciones de acceso:

Señal de notificador:

Véase también Qt::AA_DontShowShortcutsInContextMenus.

[read-only] singleClickActivation : const bool

Esta propiedad indica si los elementos se activan con un solo clic o con doble clic.

Esta propiedad es true si los elementos deben activarse con un solo clic, false si deben activarse con doble clic.

Funciones de acceso:

[read-only] startDragDistance : int

Esta propiedad contiene la distancia, en píxeles, que el ratón debe ser movido con un botón pulsado antes de que comience una operación de arrastrar y soltar.

Si usted soporta arrastrar y soltar en su aplicación, y desea iniciar una operación de arrastrar y soltar después de que el usuario haya movido el cursor una cierta distancia con un botón pulsado, debe utilizar el valor de esta propiedad como la distancia mínima requerida.

Por ejemplo, si la posición del ratón del clic se almacena en startPos y la posición actual (por ejemplo, en el evento de movimiento del ratón) es currentPos, puedes averiguar si se debe iniciar un arrastre con código como este:

if ((startPos - currentPos).manhattanLength() >=
        QApplication::startDragDistance())
    startTheDrag();

Funciones de acceso:

Señal del notificador:

Véase también startDragTime, QPoint::manhattanLength(), y Arrastrar y soltar.

[read-only] startDragTime : int

Esta propiedad contiene el tiempo, en milisegundos, que un botón del ratón debe mantenerse pulsado antes de que comience una operación de arrastrar y soltar.

Si tu aplicación permite arrastrar y soltar, y quieres iniciar una operación de arrastrar y soltar después de que el usuario haya mantenido pulsado el botón del ratón durante un cierto tiempo, debes utilizar el valor de esta propiedad como retardo.

Funciones de acceso:

Señal del notificador:

Véase también startDragDistance y Arrastrar y soltar.

[read-only] startDragVelocity : const int

Esta propiedad contiene el límite de velocidad, en píxeles por segundo, a la 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 tal límite.

Funciones de acceso:

Véase también startDragDistance y Arrastrar y soltar.

[read-only] tabFocusBehavior : Qt::TabFocusBehavior

Esta propiedad contiene el comportamiento del foco al pulsar la tecla tabulador.

Funciones de acceso:

Señal de notificador:

[read-only] touchDoubleTapDistance : const int

Esta propiedad indica la distancia máxima, en píxeles, a la que puede desplazarse un dedo entre dos pulsaciones consecutivas sin que se detecte que se trata de una doble pulsación.

Funciones de acceso:

useHoverEffects : bool

Esta propiedad indica si los elementos de la interfaz de usuario utilizan efectos hover.

Esta propiedad es true si los elementos de la interfaz de usuario deben utilizar efectos hover. Este es el comportamiento estándar en plataformas de escritorio con un puntero de ratón, mientras que en plataformas táctiles la sobrecarga de la entrega de eventos hover puede ser evitada.

Funciones de acceso:

Señal de notificador:

[read-only] useRtlExtensions : const bool

Esta propiedad contiene la dirección de escritura.

Esta propiedad es true si la dirección de escritura de derecha a izquierda está activada, en caso contrario false.

Funciones de acceso:

[read-only] wheelScrollLines : int

Número de líneas a desplazar por defecto para cada clic de la rueda.

Funciones de acceso:

Señal del notificador: