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é encapsulent les paramètres d'accessibilité dépendant de la plate-forme, par exemple si l'utilisateur souhaite que l'application soit à fort contraste ou non.

Cette propriété a été introduite dans Qt 6.10.

Fonctions d'accès :

Voir également QAccessibilityHints.

[since 6.5] colorScheme : Qt::ColorScheme

Cette propriété définit la palette de couleurs utilisée par l'application.

Par défaut, elle suit le modèle de couleurs par défaut du système (également connu sous le nom d'apparence) et change lorsque le modèle de couleurs du système change (par exemple, au crépuscule ou à l'aube). La définition d'une valeur explicite pour la palette de couleurs permet de remplacer le réglage du système et d'ignorer toute modification de la palette de couleurs du système. Cependant, cela constitue un indice pour le système, et le fait d'ignorer la palette de couleurs n'est pas pris en charge sur toutes les plates-formes.

En réinitialisant cette propriété ou en lui attribuant la valeur Qt::ColorScheme::Unknown, vous supprimez la priorité et l'application suit à nouveau la valeur par défaut du système. La valeur de la propriété changera pour le schéma de couleurs que le système a actuellement.

Lorsque cette propriété change, Qt lit la palette du système et met à jour la palette par défaut, mais n'écrase pas les entrées de la 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 sélectionnées pour fonctionner correctement 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 propriété a été introduite dans Qt 6.5.

Fonctions d'accès :

Signal Notifier :

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

[since 6.8] contextMenuTrigger : Qt::ContextMenuTrigger

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

Sur les systèmes UNIX, le menu contextuel s'affiche par défaut lorsque le bouton de la souris est enfoncé, tandis que sur Windows, il s'affiche lorsque le bouton de la souris est relâché. Cette propriété peut être utilisée pour remplacer le comportement par défaut de la plate-forme.

Cette propriété a été introduite dans Qt 6.8.

Fonctions d'accès :

Notifier signal :

Voir aussi Qt::ContextMenuTrigger.

[read-only] cursorFlashTime : int

Cette propriété définit le temps de clignotement du curseur de texte en millisecondes.

Le temps de clignotement est le temps utilisé pour afficher, inverser et restaurer l'affichage du curseur. En général, le curseur de texte est affiché pendant la moitié du temps de clignotement du curseur, puis caché pendant le même laps de temps.

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 répétées sur les touches seront automatiquement générées si une touche est maintenue enfoncée.

Cette propriété a été introduite dans Qt 6.5.

Fonctions d'accès :

[read-only] keyboardInputInterval : int

Cette propriété contient la limite de temps, en millisecondes, qui distingue une pression sur une touche de deux pressions consécutives.

Fonctions d'accès :

Signal de notification :

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

la sélection de menu s'enroule autour.

Renvoie true si la sélection de menu s'enroule. C'est-à-dire si la navigation par touche déplace la sélection vers le premier élément du menu une fois que le dernier élément du menu a été atteint, et vice versa.

Cette propriété a été introduite dans Qt 6.10.

Fonctions d'accès :

[read-only] mouseDoubleClickDistance : const int

Cette propriété indique la distance maximale, en pixels, à laquelle la souris peut être déplacée entre deux clics consécutifs sans que cela ne soit détecté comme un double-clic.

Fonctions d'accès :

[read-only] mouseDoubleClickInterval : int

Cette propriété indique la limite de temps en millisecondes qui distingue un double clic de deux clics de souris consécutifs.

Fonctions d'accès :

Signal de notification :

[read-only] mousePressAndHoldInterval : int

Cette propriété contient la limite de temps en millisecondes qui active une pression et un maintien.

Fonctions d'accès :

Signal de notification :

mouseQuickSelectionThreshold : int

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

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

Si la valeur de la propriété est inférieure ou égale à 0, la fonction 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 le temps, en millisecondes, pendant lequel une lettre tapée est affichée en clair 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 définir le focus d'entrée sur les objets focus.

Cette propriété est true si les objets cibles (édition de lignes, etc.) doivent recevoir le focus d'entrée après un relâchement du toucher ou de la souris. Il s'agit d'un comportement normal sur les plateformes tactiles. Sur les plates-formes de bureau, la norme est de définir le focus dès l'appui sur la touche/souris.

Fonctions d'accès :

[read-only] showIsFullScreen : const bool

Cette propriété indique si la plate-forme utilise par défaut des fenêtres en plein écran.

Cette propriété vaut true si la plate-forme affiche par défaut les fenêtres en plein écran, et false dans le cas contraire.

Fonctions d'accès :

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

[read-only] showIsMaximized : const bool

Cette propriété indique si la plate-forme utilise par défaut des fenêtres maximisées.

Cette propriété vaut true si la plate-forme affiche par défaut les fenêtres maximisées, et false dans le cas contraire.

Fonctions d'accès :

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

showShortcutsInContextMenus : bool

true si la plate-forme affiche normalement les séquences de touches de raccourci dans les menus contextuels, sinon false.

Depuis Qt 5.13, la fonction setShowShortcutsInContextMenus() peut être utilisée pour remplacer la valeur par défaut de la plate-forme.

Fonctions d'accès :

Signal Notifier :

Voir aussi Qt::AA_DontShowShortcutsInContextMenus.

[read-only] singleClickActivation : const bool

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

Cette propriété vaut true si les éléments doivent être activés par simple clic, false s'ils doivent être activés par double clic.

Fonctions d'accès :

[read-only] startDragDistance : int

Cette propriété indique la distance, en pixels, à laquelle la souris doit être déplacée en maintenant le bouton enfoncé avant qu'une opération de glisser-déposer ne commence.

Si vous prenez en charge le glisser-déposer dans votre application et que vous souhaitez lancer une opération de glisser-déposer après que l'utilisateur a déplacé le curseur d'une certaine distance en maintenant le 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, dans l'événement de déplacement de la souris) est currentPos, vous pouvez déterminer si une opération de glisser-déposer doit être lancée à l'aide d'un code tel que celui-ci :

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

Fonctions d'accès :

Notifier signal :

Voir également startDragTime, QPoint::manhattanLength(), et Drag and Drop.

[read-only] startDragTime : int

Cette propriété indique le temps, en millisecondes, pendant lequel le bouton de la souris doit être maintenu enfoncé avant qu'une opération de glisser-déposer ne commence.

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

Fonctions d'accès :

Signal Notifier :

Voir aussi startDragDistance et Drag and Drop.

[read-only] startDragVelocity : const int

Cette propriété définit la vitesse maximale, en pixels par seconde, à laquelle la souris peut être déplacée, avec un bouton maintenu 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 aussi startDragDistance et Glisser-déposer.

[read-only] tabFocusBehavior : Qt::TabFocusBehavior

Cette propriété définit le comportement du focus en cas d'appui sur la touche de tabulation.

Fonctions d'accès :

Signal de notification :

[read-only] touchDoubleTapDistance : const int

Cette propriété indique la distance maximale, en pixels, à laquelle un doigt peut être déplacé entre deux pressions consécutives sans que cela ne soit détecté comme une double pression.

Fonctions d'accès :

useHoverEffects : bool

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

Cette propriété est true si les éléments de l'interface utilisateur doivent utiliser les effets de survol. C'est le comportement standard sur les plates-formes de bureau avec un pointeur de souris, tandis que sur les plates-formes tactiles, le surcoût lié à l'envoi d'événements de survol peut être évité.

Fonctions d'accès :

Signal du notificateur :

[read-only] useRtlExtensions : const bool

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

Cette propriété vaut true si le sens d'écriture de droite à gauche est activé, sinon false.

Fonctions d'accès :

[read-only] wheelScrollLines : int

Nombre de lignes à faire défiler par défaut à chaque clic de roue.

Fonctions d'accès :

Signal du notificateur :