Compartir a través de

HIGHCONTRAST (Windows Embedded CE 6.0)

  • Artículo

1/6/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

Header winuser.h
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

SystemParametersInfo

Concepts

Enabling High Contrast

Other Resources

Accessibility Structures