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

Статья
11/20/2024

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

Синтаксис

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

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