HIGHCONTRASTW structure

Contains information about the high contrast accessibility feature.This feature sets the appearance scheme of the user interface for maximum visibility for a visually-impaired user, and advises applications to comply with this appearance scheme.

Syntax

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

Members

        `cbSize`

        Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">UINT</a></b>

Specifies the size, in bytes, of this structure.

        `dwFlags`

        Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">DWORD</a></b>

Specifies a combination of the following values:

Value Meaning
HCF_HIGHCONTRASTON
0x00000001
The high contrast feature is on.
HCF_AVAILABLE
0x00000002
The high contrast feature is available.
HCF_HOTKEYACTIVE
0x00000004
The user can turn the high contrast feature on and off by simultaneously pressing the left ALT, left SHIFT, and PRINT SCREEN keys.
HCF_CONFIRMHOTKEY
0x00000008
A confirmation dialog appears when the high contrast feature is activated by using the hot key.
HCF_HOTKEYSOUND
0x00000010
A siren is played when the user turns the high contrast feature on or off by using the hot key.
HCF_INDICATOR
0x00000020
A visual indicator is displayed when the high contrast feature is on. This value is not currently used and is ignored.
HCF_HOTKEYAVAILABLE
0x00000040
The hot key associated with the high contrast feature can be enabled. An application can retrieve this value, but cannot set it.
No flag name supported
0x00001000

Passing HIGHCONTRASTSTRUCTURE in calls to the SystemParametersInfoW function can cause theme change effects even if the theme isn't being changed. For example, the WM_THEMECHANGED message is sent to Windows even if the only change is to HCF_HOTKEYSOUND.

To prevent this, include this flag value in the call to SystemParametersInfo.

Note

This flag should not be used when toggling the high contrast mode (HCF_HIGHCONTRASTON).

`lpszDefaultScheme`
        Type: <b><a href="https://docs.microsoft.com/windows/desktop/WinProg/windows-data-types">LPTSTR</a></b>

Points to a string that contains the name of the color scheme that will be set to the default scheme.

## Remarks
    An application uses this structure when calling one of the [SystemParametersInfoW function](nf-winuser-systemparametersinfow.md) with the <b>SPI_GETHIGHCONTRAST</b> or <b>SPI_SETHIGHCONTRAST</b> value. When using <b>SPI_GETHIGHCONTRAST</b>, an application must specify the <b>cbSize</b> member of the <b>HIGHCONTRAST</b> structure; the <b>SystemParametersInfo</b> function fills the remaining members. An application must specify all structure members when using the <b>SPI_SETHIGHCONTRAST</b> value.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header winuser.h (include Windows.h)
## See Also

    [SystemParametersInfoW function](nf-winuser-systemparametersinfow.md), [HIGHCONTRASTA structure](ns-winuser-highcontrasta.md), <a href="https://docs.microsoft.com/windows/desktop/WinAuto/accessibility-structures">Accessibility Structures</a>,

SystemParametersInfo