HIGHCONTRASTA-Struktur (winuser.h)

Artikel
08/28/2023

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

Freigeben über