Structure HIGHCONTRASTW (winuser.h)

Article
03/04/2024

Contient des informations sur la fonctionnalité d’accessibilité à contraste élevé. Cette fonctionnalité définit le schéma d’apparence de l’interface utilisateur pour une visibilité maximale pour un utilisateur malvoyant et conseille aux applications de se conformer à ce schéma d’apparence.

Syntaxe

typedef struct tagHIGHCONTRASTW {
  UINT   cbSize;
  DWORD  dwFlags;
  LPWSTR lpszDefaultScheme;
} HIGHCONTRASTW, *LPHIGHCONTRASTW;

Membres

cbSize

Type : UINT

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

dwFlags

Type : DWORD

Spécifie une combinaison des valeurs suivantes :

Valeur	Signification
HCF_HIGHCONTRASTON 0x00000001	La fonctionnalité de contraste élevé est activée.
HCF_AVAILABLE 0x00000002	La fonctionnalité de contraste élevé est disponible.
HCF_HOTKEYACTIVE 0x00000004	L’utilisateur peut activer et désactiver la fonctionnalité de contraste élevé en appuyant simultanément sur les touches ALT gauche, MAJ gauche et IMPRIMER L’ÉCRAN.
HCF_CONFIRMHOTKEY 0x00000008	Une boîte de dialogue de confirmation s’affiche lorsque la fonctionnalité de contraste élevé est activée à l’aide de la touche de raccourci.
HCF_HOTKEYSOUND 0x00000010	Une sirène est lue lorsque l’utilisateur active ou désactive la fonctionnalité de contraste élevé à l’aide de la touche de raccourci.
HCF_INDICATOR 0x00000020	Un indicateur visuel s’affiche lorsque la fonctionnalité de contraste élevé est activée. Cette valeur n’est actuellement pas utilisée et est ignorée.
HCF_HOTKEYAVAILABLE 0x00000040	La touche d’accès rapide associée à la fonctionnalité de contraste élevé peut être activée. Une application peut récupérer cette valeur, mais ne peut pas la définir.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Le passage de HIGHCONTRASTSTRUCTURE dans les appels à SystemParametersInfoW peut entraîner des effets de modification de thème même si le thème n’est pas modifié. Par exemple, le message WM_THEMECHANGED est envoyé à Windows même si la seule modification concerne HCF_HOTKEYSOUND. Pour éviter cela, incluez l’indicateur HCF_OPTION_NOTHEMECHANGE dans l’appel à SystemParametersInfo. Notes L’indicateur HCF_OPTION_NOTHEMECHANGE ne doit pas être utilisé lors de la désactivation du mode de contraste élevé (HCF_HIGHCONTRASTON).
HCF_OPTION_NOTHEMECHANGE 0x00001000	Le passage de HIGHCONTRASTSTRUCTURE dans les appels à SystemParametersInfoW peut entraîner des effets de modification de thème même si le thème n’est pas modifié. Par exemple, le message WM_THEMECHANGED est envoyé à Windows même si la seule modification concerne HCF_HOTKEYSOUND. Pour éviter cela, incluez l’indicateur HCF_OPTION_NOTHEMECHANGE dans l’appel à SystemParametersInfo. Notes L’indicateur HCF_OPTION_NOTHEMECHANGE ne doit pas être utilisé lors de la désactivation du mode de contraste élevé (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Type : LPTSTR

Pointe vers une chaîne qui contient le nom du jeu de couleurs qui sera défini sur le schéma par défaut. Le système alloue cette mémoire tampon, la libère avec LocalFree.

Remarques

Une application utilise cette structure lors de l’appelde la fonction SystemParametersInfoW avec la valeur SPI_GETHIGHCONTRAST ou SPI_SETHIGHCONTRAST . Lors de l’utilisation de SPI_GETHIGHCONTRAST, une application doit spécifier le membre cbSize de la structure HIGHCONTRAST ; la fonction SystemParametersInfo remplit les membres restants. Une application doit spécifier tous les membres de la structure lors de l’utilisation de la valeur SPI_SETHIGHCONTRAST .

Notes

L’en-tête winuser.h définit HIGHCONTRAST comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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

Fonction SystemParametersInfoW, structure HIGHCONTRASTA, Structures d’accessibilité, SystemParametersInfo

Partager via