HIGHCONTRAST

A version of this page is also available for

Windows Embedded CE 6.0 R3

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 to TEXT("High Contrast White"). To set the color scheme to high-contrast black, set this parameter equal to TEXT("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

See Also

Reference

SystemParametersInfo

Concepts

Enabling High Contrast

Other Resources

Accessibility Structures