Partager via


STRUCTURE HIGHCONTRASTA (winuser.h)

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é 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 d’accès rapide.
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 d’accès rapide.
HCF_INDICATOR
0x00000020
Un indicateur visuel s’affiche lorsque la fonctionnalité de contraste élevé est activée. Cette valeur n’est pas utilisée actuellement 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

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 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 du basculement 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 modèle par défaut.

Remarques

Une application utilise cette structure lors de l’appel de lafonction SystemParametersInfoA 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 en tant qu’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. La combinaison 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.

Spécifications

   
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

SystemParametersInfoA, structure HIGHCONTRASTW, structures d’accessibilité, SystemParametersInfo