HIGHCONTRASTA, structure (winuser.h)

Article
11/20/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 tagHIGHCONTRASTA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszDefaultScheme;
} HIGHCONTRASTA, *LPHIGHCONTRASTA;

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é à contraste élevé en appuyant simultanément sur les touches Alt gauche, Maj gauche et ÉCRAN D’IMPRESSION.
HCF_CONFIRMHOTKEY 0x00000008	Une boîte de dialogue de confirmation s’affiche lorsque la fonctionnalité à contraste élevé est activée à l’aide de la touche chaude.
HCF_HOTKEYSOUND 0x00000010	Une sirène est jouée lorsque l’utilisateur active ou désactive la fonctionnalité de contraste élevé à l’aide de la touche chaude.
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 chaude 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	La transmission de HIGHCONTRASTSTRUCTURE dans les appels à SystemParametersInfoA 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 est de HCF_HOTKEYSOUND. Pour éviter cela, incluez l’indicateur HCF_OPTION_NOTHEMECHANGE dans l’appel à SystemParametersInfo. Note L’indicateur HCF_OPTION_NOTHEMECHANGE ne doit pas être utilisé lors du basculement du mode 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.

Remarques

Une application utilise cette structure lors de l’appel de la fonction SystemParametersInfoA avec la valeur SPI_GETHIGHCONTRAST ou SPI_SETHIGHCONTRAST. Lorsque vous utilisez 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 structure lors de l’utilisation de la valeur SPI_SETHIGHCONTRAST.

Note

L’en-tête winuser.h définit HIGHCONTRAST comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	winuser.h (include Windows.h)

Voir aussi

fonction SystemParametersInfoA, structure HIGHCONTRASTW, Structures d’accessibilité, SystemParametersInfo

Partager via