HIGHCONTRAST
A version of this page is also available for
4/8/2010
This structure contains information about the high-contrast mode accessibility option. The high-contrast mode option sets the appearance scheme of the user interface (UI) to provide maximum visibility for a user with low vision and advises applications to comply with this appearance scheme.
Syntax
typedef struct tagHIGHCONTRAST{
UINT cbSize;
DWORD dwFlags;
LPTSTR lpszDefaultScheme;
} HIGHCONTRAST, FAR* LPHIGHCONTRAST;
Members
- cbSize
Unsigned integer that specifies the size, in bytes, of this structure.
dwFlags
DWORD that contains a set of bit flags that specify properties of the high-contrast mode option. The following table shows the possible values, which you can combine.Value Description HCF_AVAILABLE
The high-contrast mode is available for use.
HCF_HIGHCONTRASTON
The high-contrast mode is on.
HCF_HOTKEYACTIVE
The user can turn the high-contrast mode on and off by pressing the Left ALT + Left SHIFT + PRINT SCREEN.
HCF_HOTKEYAVAILABLE
An application can enable the hot key associated with the high-contrast mode. An application can retrieve this value but cannot set it.
HCF_HOTKEYSOUND
The OS plays a siren sound when the user turns the high-contrast mode on or off by using the hot key.
- lpszDefaultScheme
Pointer to a string buffer that either contains the name of a color scheme when you call SystemParametersInfo with the SPI_SETHIGHCONTRAST flag or is empty when you call SystemParametersInfo with the SPI_GETHIGHCONTRAST flag. To set the color scheme to high-contrast white, set this parameter equal toTEXT("High Contrast White"). To set the color scheme to high-contrast black, set this parameter equal toTEXT("High Contrast Black"). Setting this parameter to any other value sets the color scheme to the default color scheme.
Remarks
Use this structure when you call the SystemParametersInfo function with the uiAction parameter set to the SPI_GETHIGHCONTRAST or SPI_SETHIGHCONTRAST value. When using SPI_GETHIGHCONTRAST, you must specify the cbSize member of the HIGHCONTRAST structure; the SystemParametersInfo function fills in the remaining members. Specify all structure members when using the SPI_SETHIGHCONTRAST value.
Requirements
| Header | winuser.h |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |