Поделиться через

Структура HIGHCONTRASTA (winuser.h)

Содержит сведения о функции высокой контрастности. Эта функция задает схему внешнего вида пользовательского интерфейса для максимальной видимости для пользователя с нарушениями визуального зрения и советует приложениям соответствовать этой схеме внешнего вида.

Синтаксис

typedef struct tagHIGHCONTRASTA {
  UINT  cbSize;
  DWORD dwFlags;
  LPSTR lpszDefaultScheme;
} HIGHCONTRASTA, *LPHIGHCONTRASTA;

Члены

cbSize

Тип: UINT

Задает размер в байтах этой структуры.

dwFlags

Тип: DWORD

Задает сочетание следующих значений:

Ценность Значение
HCF_HIGHCONTRASTON
0x00000001
 Функция высокой контрастности включена.
HCF_AVAILABLE
0x00000002
 Функция высокой контрастности доступна.
HCF_HOTKEYACTIVE
0x00000004
 Пользователь может включить и отключить функцию высокой контрастности, одновременно нажав клавиши ALT слева, SHIFT и PRINT SCREEN.
HCF_CONFIRMHOTKEY
0x00000008
 Диалоговое окно подтверждения появляется при активации функции высокой контрастности с помощью горячего ключа.
HCF_HOTKEYSOUND
0x00000010
 Сирена воспроизводится, когда пользователь включает или отключает функцию высокой контрастности с помощью горячего ключа.
HCF_INDICATOR
0x00000020
 Визуальный индикатор отображается при включении функции высокой контрастности. Это значение в настоящее время не используется и игнорируется.
HCF_HOTKEYAVAILABLE
0x00000040
 Горячий ключ, связанный с функцией высокой контрастности, можно включить. Приложение может получить это значение, но не может задать его.
HCF_OPTION_NOTHEMECHANGE
0x00001000

Передача HIGHCONTRASTSTRUCTURE в вызовах SystemParametersInfoA может вызвать эффекты изменения темы, даже если тема не изменяется. Например, сообщение WM_THEMECHANGED отправляется в Windows, даже если единственным изменением является HCF_HOTKEYSOUND.

Чтобы предотвратить это, включите флаг HCF_OPTION_NOTHEMECHANGE в вызов SystemParametersInfo.

Заметка

Флаг HCF_OPTION_NOTHEMECHANGE не следует использовать при переключение режима высокой контрастности (HCF_HIGHCONTRASTON).

lpszDefaultScheme

Тип: LPTSTR

Указывает на строку, содержащую имя цветовой схемы, которая будет присвоена схеме по умолчанию.

Замечания

Приложение использует эту структуру при вызове функции SystemParametersInfoA со значением SPI_GETHIGHCONTRAST или SPI_SETHIGHCONTRAST. При использовании SPI_GETHIGHCONTRASTприложение должно указать cbSize член структуры HIGHCONTRAST; функция SystemParametersInfo заполняет остальные элементы. Приложение должно указывать все элементы структуры при использовании значения SPI_SETHIGHCONTRAST.

Заметка

Заголовок winuser.h определяет HIGHCONTRAST как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
заголовка winuser.h (включая Windows.h)

См. также

функции SystemParametersInfoA, структуру HIGHCONTRASTW, структуры специальных возможностей, SystemParametersInfo