QStyleHints Class

Documentation sur les propriétés

[read-only, since 6.10] accessibility : const QAccessibilityHints*

Cette propriété contient les conseils d'accessibilité de l'application.

Les conseils d'accessibilité regroupent les paramètres d'accessibilité spécifiques à la plateforme, tels que le choix de l'utilisateur d'afficher ou non l'application en mode contraste élevé.

Cette énumération a été introduite dans Qt 6.10.

Fonctions d'accès :

Voir également QAccessibilityHints.

[since 6.5] colorScheme : Qt::ColorScheme

Cette propriété contient le thème de couleurs utilisé par l'application.

Par défaut, elle suit la palette de couleurs par défaut du système (également appelée « apparence ») et change lorsque la palette de couleurs du système change (par exemple, au crépuscule ou à l'aube). Définir la palette de couleurs sur une valeur explicite remplacera le paramètre système et ignorera toute modification apportée à la palette de couleurs du système. Cependant, cette action constitue une indication pour le système, et le remplacement de la palette de couleurs n’est pas pris en charge sur toutes les plateformes.

Réinitialiser cette propriété, ou la définir sur ` Qt::ColorScheme::Unknown`, supprimera la dérogation et fera en sorte que l'application suive à nouveau la configuration par défaut du système. La valeur de la propriété sera alors définie sur la palette de couleurs actuellement utilisée par le système.

Lorsque cette propriété change, Qt lit la palette système et met à jour la palette par défaut, mais ne remplace pas les entrées de palette qui ont été explicitement définies par l’application. Lorsque le signal colorSchemeChange() est émis, l’ancienne palette est toujours en vigueur.

Les couleurs spécifiques à l’application doivent être choisies de manière à s’harmoniser avec la palette effective, en tenant compte du schéma de couleurs actuel. Pour mettre à jour les couleurs spécifiques à l’application lorsque la palette effective change, gérez les événements ` PaletteChange ` ou ` ApplicationPaletteChange `.

Cette énumération a été introduite dans Qt 6.5.

Fonctions d’accès :

Signal de notification :

Voir également Qt::ColorScheme, QGuiApplication::palette() et QEvent::PaletteChange.

[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger

Événement de souris utilisé pour déclencher un menu contextuel.

Par défaut, sur les systèmes UNIX, le menu contextuel s'affiche lors de l'événement « pression sur le bouton de la souris », tandis que sous Windows, c'est lors de l'événement « relâchement du bouton de la souris ». Cette propriété permet de remplacer le comportement par défaut de la plateforme.

Cette énumération a été introduite dans Qt 6.8.

Fonctions d'accès :

Signal Notifier :

Voir également Qt::ContextMenuTrigger.

[read-only] cursorFlashTime : int

Cette propriété définit la durée de clignotement du curseur texte, exprimée en millisecondes.

La durée de clignotement correspond au temps nécessaire pour afficher, inverser et rétablir l'affichage du curseur. En général, le curseur de texte s'affiche pendant la moitié de la durée de clignotement, puis reste masqué pendant la même durée.

Fonctions d'accès :

Signal de notification :

[read-only] fontSmoothingGamma : const qreal

Cette propriété contient la valeur gamma utilisée pour le lissage des polices.

Fonctions d'accès :

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

Cette propriété définit la fréquence, en événements par seconde, à laquelle des pressions supplémentaires répétées sur une touche seront automatiquement générées si celle-ci est maintenue enfoncée.

Cette énumération a été introduite dans Qt 6.5.

Fonctions d'accès :

[read-only] keyboardInputInterval : int

Cette propriété définit le délai, en millisecondes, qui permet de distinguer une simple pression sur une touche de deux pressions consécutives sur la même touche.

Fonctions d'accès :

Signal de notification :

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

La sélection dans le menu revient au début.

Renvoie « true » si la sélection du menu boucle. Autrement dit, si la navigation au clavier ramène la sélection au premier élément du menu après avoir atteint le dernier élément, et inversement.

Cette énumération a été introduite dans Qt 6.10.

Fonctions d'accès :

[read-only] mouseDoubleClickDistance : const int

Cette propriété définit la distance maximale, en pixels, sur laquelle la souris peut être déplacée entre deux clics consécutifs pour que ceux-ci soient toujours détectés comme un double-clic

Fonctions d'accès :

[read-only] mouseDoubleClickInterval : int

Cette propriété définit le délai, en millisecondes, qui permet de distinguer un double-clic de deux clics de souris consécutifs.

Fonctions d'accès :

Signal de notification :

[read-only] mousePressAndHoldInterval : int

Cette propriété définit le délai, en millisecondes, à l'issue duquel une action « appuyer et maintenir » est déclenchée.

Fonctions d'accès :

Signal de notification :

mouseQuickSelectionThreshold : int

Seuil de sélection rapide de la souris dans « QLineEdit ».

Cette propriété définit la distance sur laquelle le curseur de la souris doit être déplacé le long de l'axe y pour déclencher une sélection rapide lors d'une sélection de texte normale dans QLineEdit.

Si la valeur de cette propriété est inférieure ou égale à 0, la fonctionnalité de sélection rapide est désactivée.

Fonctions d’accès :

Signal de notification :

[read-only] passwordMaskCharacter : const QChar

Cette propriété contient le caractère utilisé pour masquer les caractères saisis dans les champs de saisie de texte en mode mot de passe.

Fonctions d'accès :

[read-only] passwordMaskDelay : const int

Cette propriété indique la durée, en millisecondes, pendant laquelle une lettre saisie s'affiche à l'écran dans un champ de saisie de texte en mode mot de passe.

Fonctions d'accès :

[read-only] setFocusOnTouchRelease : const bool

Cette propriété contient l'événement qui doit placer le focus sur les objets de focus.

Cette propriété est définie sur « true » si les objets de focus (champs de saisie, etc.) doivent recevoir le focus après le relâchement du toucher ou du clic de souris. Il s’agit d’un comportement normal sur les plateformes tactiles. Sur les plateformes de bureau, la norme consiste à attribuer le focus dès la pression du doigt ou du clic de souris.

Fonctions d'accès :

[read-only] showIsFullScreen : const bool

Cette propriété indique si la plateforme affiche par défaut les fenêtres en plein écran.

Cette propriété prend la valeur « true » si la plateforme affiche par défaut les fenêtres en plein écran, sinon elle prend la valeur « false ».

Fonctions d'accès :

Voir également QWindow::show() et showIsMaximized().

[read-only] showIsMaximized : const bool

Cette propriété indique si la plateforme affiche par défaut les fenêtres en mode plein écran.

Cette propriété prend la valeur « true » si la plate-forme affiche par défaut les fenêtres en mode maximisé, sinon elle prend la valeur « false ».

Fonctions d'accès :

Voir également QWindow::show() et showIsFullScreen().

showShortcutsInContextMenus : bool

true si la plateforme affiche normalement les combinaisons de touches de raccourci dans les menus contextuels ; sinon, false.

Depuis Qt 5.13, la fonction setShowShortcutsInContextMenus() permet de remplacer le comportement par défaut de la plateforme.

Fonctions d'accès :

Signal Notifier :

Voir également Qt::AA_DontShowShortcutsInContextMenus.

[read-only] singleClickActivation : const bool

Cette propriété détermine si les éléments sont activés par un simple clic ou par un double clic.

Cette propriété prend la valeur « true » si les éléments doivent être activés par un simple clic, et « false » s'ils doivent être activés par un double-clic.

Fonctions d'accès :

[read-only] startDragDistance : int

Cette propriété définit la distance, en pixels, sur laquelle le curseur doit être déplacé avec un bouton enfoncé avant qu'une opération de glisser-déposer ne commence.

Si votre application prend en charge le glisser-déposer et que vous souhaitez lancer une opération de glisser-déposer une fois que l'utilisateur a déplacé le curseur d'une certaine distance en maintenant un bouton enfoncé, vous devez utiliser la valeur de cette propriété comme distance minimale requise.

Par exemple, si la position de la souris au moment du clic est stockée dans startPos et que la position actuelle (par exemple, lors de l'événement de déplacement de la souris) est currentPos, vous pouvez déterminer si un glissement doit être lancé à l'aide d'un code similaire à celui-ci :

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

Fonctions d'accès :

Signal de notification :

Voir également startDragTime, QPoint::manhattanLength() et Glisser-déposer.

[read-only] startDragTime : int

Cette propriété définit le délai, en millisecondes, pendant lequel un bouton de souris doit rester enfoncé avant qu'une opération de glisser-déposer ne commence.

Si votre application prend en charge le glisser-déposer et que vous souhaitez lancer une opération de glisser-déposer après que l'utilisateur a maintenu un bouton de souris enfoncé pendant un certain temps, vous devez utiliser la valeur de cette propriété comme délai.

Fonctions d'accès :

Signal de notification :

Voir également « startDragDistance » et « Glisser-déposer ».

[read-only] startDragVelocity : const int

Cette propriété définit la limite de vitesse, en pixels par seconde, à laquelle la souris peut être déplacée, avec un bouton enfoncé, pour qu'une opération de glisser-déposer puisse commencer. Une valeur de 0 signifie qu'il n'y a pas de limite.

Fonctions d'accès :

Voir également « startDragDistance » et « Glisser-déposer ».

[read-only] tabFocusBehavior : Qt::TabFocusBehavior

Cette propriété définit le comportement du focus lorsque l'on appuie sur la touche Tab.

Fonctions d'accès :

Signal de notification :

[since 6.12] toolTipWakeUpDelay : std::chrono::milliseconds

Cette propriété définit le délai avant l'affichage des infobulles.

Cette énumération a été introduite dans Qt 6.12.

Fonctions d'accès :

Signal de notification :

Voir également QWidget::toolTip et QtQuick.Controls::ToolTip::delay.

[read-only, since 6.12] toolTipWakeUpDelayAsMSec : int

Cette propriété définit le délai, en millisecondes, avant l'affichage des infobulles.

Cette énumération a été introduite dans Qt 6.12.

Fonctions d'accès :

Signal de notification :

Voir également toolTipWakeUpDelay et QtQuick.Controls::ToolTip::delay.

[read-only] touchDoubleTapDistance : const int

Cette propriété définit la distance maximale, en pixels, sur laquelle un doigt peut être déplacé entre deux tapotements consécutifs pour que ceux-ci soient toujours détectés comme un double tapotement

Fonctions d'accès :

useHoverEffects : bool

Cette propriété détermine si les éléments de l'interface utilisateur utilisent des effets au survol.

Cette propriété est définie sur « true » si les éléments de l'interface utilisateur doivent utiliser des effets au survol. Il s'agit du comportement par défaut sur les plateformes de bureau équipées d'un pointeur de souris, tandis que sur les plateformes tactiles, la charge liée à la génération d'événements de survol peut être évitée.

Fonctions d'accès :

Signal du notificateur :

[read-only] useRtlExtensions : const bool

Cette propriété détermine le sens d'écriture.

Cette propriété prend la valeur « true » si le sens d’écriture de droite à gauche est activé, et « false » dans le cas contraire.

Fonctions d'accès :

[read-only] wheelScrollLines : int

Nombre de lignes à faire défiler par défaut à chaque clic sur la molette.

Fonctions d'accès :

Signal de notification :