Share via

HIGHCONTRAST

  • Article

The HIGHCONTRAST structure contains information about the high contrast accessibility feature, which 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.

typedef struct tagHIGHCONTRAST {
    UINT    cbSize; 
    DWORD   dwFlags; 
    LPTSTR  lpszDefaultScheme; 
} HIGHCONTRAST, *LPHIGHCONTRAST;

Members

  • cbSize
    Specifies the size, in bytes, of this structure.

  • dwFlags
    Specifies a combination of the following values:

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

  • lpszDefaultScheme
    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 the SystemParametersInfo function with the SPI_GETHIGHCONTRAST or SPI_SETHIGHCONTRAST value. When using SPI_GETHIGHCONTRAST, an application must specify the cbSize member of the HIGHCONTRAST structure; the SystemParametersInfo function fills the remaining members. An application must specify all structure members when using the SPI_SETHIGHCONTRAST value.

Requirements

**  Windows NT/2000/XP:** Included in Windows NT 3.1 or later.
**  Windows 95/98/Me:** Included in Windows 95 or later.
**  Header:** Declared in Winuser.h; include Windows.h.

See Also

Accessibility Structures, SystemParametersInfo