Structure FILTERKEYS (winuser.h)

Contient des informations sur la fonctionnalité d’accessibilité FilterKeys, qui permet à un utilisateur handicapé de définir le taux de répétition du clavier (RepeatKeys), le délai d’acceptation (SlowKeys) et le taux de rebond (BounceKeys).

Syntaxe

typedef struct tagFILTERKEYS {
  UINT  cbSize;
  DWORD dwFlags;
  DWORD iWaitMSec;
  DWORD iDelayMSec;
  DWORD iRepeatMSec;
  DWORD iBounceMSec;
} FILTERKEYS, *LPFILTERKEYS;

Membres

cbSize

Type : UINT

Spécifie la taille de la structure, en octets.

dwFlags

Type : DWORD

Ensemble d’indicateurs de bits qui spécifient les propriétés de la fonctionnalité FilterKeys. Les valeurs d’indicateur de bits suivantes sont définies :

Valeur	Signification
FKF_AVAILABLE 0x00000002	Les fonctionnalités FilterKeys sont disponibles.
FKF_CLICKON 0x00000040	L’ordinateur émet un son de clic lorsqu’une touche est enfoncée ou acceptée. Si SlowKeys est activé, un clic est généré lorsque la touche est enfoncée et à nouveau lorsque la frappe est acceptée.
FKF_CONFIRMHOTKEY 0x00000008	Windows 95/98, Windows 2000 : Une boîte de dialogue de confirmation s’affiche lorsque les fonctionnalités FilterKeys sont activées à l’aide de la touche de raccourci.
FKF_FILTERKEYSON 0x00000001	Les fonctionnalités FilterKeys sont activées.
FKF_HOTKEYACTIVE 0x00000004	L’utilisateur peut activer et désactiver la fonctionnalité FilterKeys en maintenant la touche MAJ DROITE enfoncée pendant huit secondes.
FKF_HOTKEYSOUND 0x00000010	Si cet indicateur est défini, l’ordinateur émet un son de sirène lorsque l’utilisateur active ou désactive la fonctionnalité FilterKeys à l’aide de la touche de raccourci.
FKF_INDICATOR 0x00000020	Windows 95, Windows 2000 : Un indicateur visuel s’affiche lorsque les fonctionnalités FilterKeys sont activées.

iWaitMSec

Type : DWORD

Spécifie la durée, en millisecondes, pendant laquelle l’utilisateur doit maintenir une clé enfoncée avant qu’elle ne soit acceptée par l’ordinateur.

iDelayMSec

Type : DWORD

Spécifie la durée, en millisecondes, pendant laquelle l’utilisateur doit maintenir une clé enfoncée avant qu’elle ne commence à se répéter.

iRepeatMSec

Type : DWORD

Spécifie la durée, en millisecondes, entre chaque répétition de la frappe.

iBounceMSec

Type : DWORD

Spécifie la durée, en millisecondes, qui doit s’écouler après la libération d’une touche avant que l’ordinateur accepte une pression ultérieure de la même touche.

Remarques

Utilisez une structure FILTERKEYS lors de l’appel de la fonction SystemParametersInfo avec le paramètre uiAction défini sur la valeur SPI_GETFILTERKEYS ou SPI_SETFILTERKEYS . Lorsque vous utilisez SPI_GETFILTERKEYS, vous devez spécifier le membre cbSize de la structure FILTERKEYS ; la fonction SystemParametersInfo remplit les membres restants. Spécifiez tous les membres de la structure lors de l’utilisation de la valeur SPI_SETFILTERKEYS .

Le membre iBounceMSec contrôle la fonctionnalité BounceKeys, et les membres iWaitMSec, iDelayMSec et iRepeatMSec travaillent ensemble pour contrôler les fonctionnalités RepeatKeys et SlowKeys. Si BounceKeys est activé (autrement dit, iBounceMSec n’est pas nul), les fonctionnalités RepeatKeys et SlowKeys sont désactivées (autrement dit, les membres iWaitMSec, iDelayMSec et iRepeatMSec doivent tous être zéro). De même, si BounceKeys est désactivé (iBounceMSec est égal à zéro), iWaitMSec, iDelayMSec et iRepeatMSec doivent tous être identiques.

La valeur maximale des membres iBounceMSec, iWaitMSec, iDelayMSec et iRepeatMSec est de 20 000 millisecondes.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)

Voir aussi

Structures d’accessibilité

SystemParametersInfo