Freigeben über


HIGHCONTRASTA-Struktur (winuser.h)

Enthält Informationen zur Barrierefreiheitsfunktion mit hohem Kontrast. Dieses Feature legt das Darstellungsschema der Benutzeroberfläche für maximale Sichtbarkeit für einen sehbehinderten Benutzer fest und empfiehlt Anwendungen, dieses Darstellungsschema einzuhalten.

Syntax

typedef struct tagHIGHCONTRASTA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszDefaultScheme;
} HIGHCONTRASTA, *LPHIGHCONTRASTA;

Member

cbSize

Typ: UINT

Gibt die Größe dieser Struktur in Bytes an.

dwFlags

Typ: DWORD

Gibt eine Kombination der folgenden Werte an:

Wert Bedeutung
HCF_HIGHCONTRASTON
0x00000001
Die Funktion mit hohem Kontrast ist aktiviert.
HCF_AVAILABLE
0x00000002
Das Feature mit hohem Kontrast ist verfügbar.
HCF_HOTKEYACTIVE
0x00000004
Der Benutzer kann das Feature mit hohem Kontrast aktivieren und deaktivieren, indem er gleichzeitig die linke ALT-, UMSCHALT- und DRUCKBILDSCHIRMTASTE drückt.
HCF_CONFIRMHOTKEY
0x00000008
Ein Bestätigungsdialogfeld wird angezeigt, wenn die Funktion mit hohem Kontrast mithilfe der Tastenkombination aktiviert wird.
HCF_HOTKEYSOUND
0x00000010
Eine Sirene wird wiedergegeben, wenn der Benutzer die Funktion mit hohem Kontrast mithilfe der Tastenkombination ein- oder ausschaltet.
HCF_INDICATOR
0x00000020
Ein visueller Indikator wird angezeigt, wenn die Funktion mit hohem Kontrast aktiviert ist. Dieser Wert wird derzeit nicht verwendet und ignoriert.
HCF_HOTKEYAVAILABLE
0x00000040
Die hot key, die dem Feature für hohen Kontrast zugeordnet ist, kann aktiviert werden. Eine Anwendung kann diesen Wert abrufen, aber nicht festlegen.
HCF_OPTION_NOTHEMECHANGE
0x00001000

Das Übergeben von HIGHCONTRASTSTRUCTURE in Aufrufen von SystemParametersInfoA kann zu Designänderungen führen, auch wenn das Design nicht geändert wird. Beispielsweise wird die WM_THEMECHANGED-Nachricht an Windows gesendet, auch wenn die einzige Änderung darin besteht, HCF_HOTKEYSOUND.

Um dies zu verhindern, schließen Sie das flag HCF_OPTION_NOTHEMECHANGE in den Aufruf von SystemParametersInfo ein.

Hinweis

Das flag HCF_OPTION_NOTHEMECHANGE sollte beim Umschalten des Modus mit hohem Kontrast (HCF_HIGHCONTRASTON) nicht verwendet werden.

lpszDefaultScheme

Typ: LPTSTR

Verweist auf eine Zeichenfolge, die den Namen des Farbschemas enthält, das auf das Standardschema festgelegt wird.

Hinweise

Eine Anwendung verwendet diese Struktur beim Aufrufen derSystemParametersInfoA-Funktion mit dem wert SPI_GETHIGHCONTRAST oder SPI_SETHIGHCONTRAST . Bei Verwendung von SPI_GETHIGHCONTRAST muss eine Anwendung den cbSize-Member der HIGHCONTRAST-Struktur angeben. Die SystemParametersInfo-Funktion füllt die verbleibenden Member aus. Eine Anwendung muss bei Verwendung des werts SPI_SETHIGHCONTRAST alle Strukturmember angeben.

Hinweis

Der winuser.h-Header definiert HIGHCONTRAST als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile winuser.h (windows.h einschließen)

Weitere Informationen

SystemParametersInfoA-Funktion, HIGHCONTRASTW-Struktur, Barrierefreiheitsstrukturen, SystemParametersInfo