HIGHCONTRASTW-Struktur (winuser.h)

Artikel
11/20/2024

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

Syntax

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

Angehörige

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 für hohen Kontrast ist aktiviert.
HCF_AVAILABLE 0x00000002	Das Feature mit hohem Kontrast ist verfügbar.
HCF_HOTKEYACTIVE 0x00000004	Der Benutzer kann die Funktion für hohen Kontrast aktivieren und deaktivieren, indem gleichzeitig die linke ALT-TASTE, die linke UMSCHALTTASTE und die DRUCKTASTEn gedrückt werden.
HCF_CONFIRMHOTKEY 0x00000008	Ein Bestätigungsdialogfeld wird angezeigt, wenn die Funktion mit hohem Kontrast mithilfe der Hot-Key aktiviert wird.
HCF_HOTKEYSOUND 0x00000010	Ein Siren wird wiedergegeben, wenn der Benutzer die Funktion mit hohem Kontrast mithilfe der Abkürzungstaste ein- oder ausschalten.
HCF_INDICATOR 0x00000020	Ein visueller Indikator wird angezeigt, wenn die Funktion mit hohem Kontrast aktiviert ist. Dieser Wert wird derzeit nicht verwendet und wird ignoriert.
HCF_HOTKEYAVAILABLE 0x00000040	Die dem Feature "Hoher Kontrast" zugeordnete Abkürzungstaste 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änderungseffekten führen, auch wenn das Design nicht geändert wird. Beispielsweise wird die WM_THEMECHANGED Nachricht an Windows gesendet, auch wenn die einzige Änderung auf HCF_HOTKEYSOUND ist. Um dies zu verhindern, schließen Sie das HCF_OPTION_NOTHEMECHANGE Flag in den Aufruf von SystemParametersInfo ein. Anmerkung Das HCF_OPTION_NOTHEMECHANGE-Flag sollte nicht verwendet werden, wenn der Modus für hohen Kontrast (HCF_HIGHCONTRASTON) umgeschaltet wird.
HCF_OPTION_NOTHEMECHANGE 0x00001000	Das Übergeben von HIGHCONTRASTSTRUCTURE in Aufrufen von SystemParametersInfoW kann zu Designänderungseffekten führen, auch wenn das Design nicht geändert wird. Beispielsweise wird die WM_THEMECHANGED Nachricht an Windows gesendet, auch wenn die einzige Änderung auf HCF_HOTKEYSOUND ist. Um dies zu verhindern, schließen Sie das HCF_OPTION_NOTHEMECHANGE Flag in den Aufruf von SystemParametersInfo ein. Anmerkung Das HCF_OPTION_NOTHEMECHANGE-Flag sollte nicht verwendet werden, wenn der Modus für hohen Kontrast (HCF_HIGHCONTRASTON) umgeschaltet wird.

lpszDefaultScheme

Typ: LPTSTR-

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

Bemerkungen

Eine Anwendung verwendet diese Struktur beim Aufrufen der SystemParametersInfoW-Funktion mit dem wert SPI_GETHIGHCONTRAST oder SPI_SETHIGHCONTRAST. Bei Verwendung von SPI_GETHIGHCONTRASTmuss eine Anwendung das cbSize- Mitglied der HIGHCONTRAST- Struktur angeben; die SystemParametersInfo Funktion füllt die verbleibenden Elemente aus. Eine Anwendung muss bei Verwendung des SPI_SETHIGHCONTRAST Werts alle Strukturmmber angeben.

Anmerkung

Der winuser.h-Header definiert HIGHCONTRAST als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	winuser.h (enthalten Windows.h)

Siehe auch

SystemParametersInfoW-Funktion, HIGHCONTRASTA-Struktur, Barrierefreiheitsstrukturen, SystemParametersInfo

Freigeben über