HIGHCONTRASTW-Struktur (winuser.h)

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

Syntax

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

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	Das Feature mit hohem Kontrast ist aktiviert.
HCF_AVAILABLE 0x00000002	Das Feature mit hohem Kontrast ist verfügbar.
HCF_HOTKEYACTIVE 0x00000004	Der Benutzer kann die Funktion mit hohem Kontrast aktivieren und deaktivieren, indem er gleichzeitig die linke ALT-, LINKE UMSCHALT- und DRUCKBILDSCHIRMTASTE drückt.
HCF_CONFIRMHOTKEY 0x00000008	Ein Bestätigungsdialogfeld wird angezeigt, wenn das Feature 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 das Feature mit hohem Kontrast aktiviert ist. Dieser Wert wird derzeit nicht verwendet und ignoriert.
HCF_HOTKEYAVAILABLE 0x00000040	Die hot key, die dem Feature mit hohem 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 SystemParametersInfoW 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, fügen Sie das HCF_OPTION_NOTHEMECHANGE-Flag in den Aufruf von SystemParametersInfo ein. Hinweis Das flag HCF_OPTION_NOTHEMECHANGE sollte nicht verwendet werden, wenn der Modus mit hohem Kontrast (HCF_HIGHCONTRASTON) umgeschaltet wird.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Das Übergeben von HIGHCONTRASTSTRUCTURE in Aufrufen von SystemParametersInfoW 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, fügen Sie das HCF_OPTION_NOTHEMECHANGE-Flag in den Aufruf von SystemParametersInfo ein. Hinweis Das flag HCF_OPTION_NOTHEMECHANGE sollte nicht verwendet werden, wenn der Modus mit hohem Kontrast (HCF_HIGHCONTRASTON) umgeschaltet wird.

lpszDefaultScheme

Typ: LPTSTR

Zeigt auf eine Zeichenfolge, die den Namen des Farbschemas enthält, das auf das Standardschema festgelegt wird. Das System weist diesen Puffer zu und gibt ihn mit LocalFree frei.

Hinweise

Eine Anwendung verwendet diese Struktur beim Aufrufen derSystemParametersInfoW-Funktion mit dem SPI_GETHIGHCONTRAST- oder SPI_SETHIGHCONTRAST-Wert . Bei Verwendung SPI_GETHIGHCONTRAST muss eine Anwendung das cbSize-Element der HIGHCONTRAST-Struktur angeben. die SystemParametersInfo-Funktion füllt die restlichen Member aus. Eine Anwendung muss bei Verwendung des SPI_SETHIGHCONTRAST-Werts 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

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

Weitere Informationen

SystemParametersInfoW-Funktion, HIGHCONTRASTA-Struktur, Barrierefreiheitsstrukturen, SystemParametersInfo