Структура IMEMENUITEMINFOA (imm.h)

Статья
11/20/2024

Содержит сведения о элементах меню IME.

Синтаксис

typedef struct tagIMEMENUITEMINFOA {
  UINT    cbSize;
  UINT    fType;
  UINT    fState;
  UINT    wID;
  HBITMAP hbmpChecked;
  HBITMAP hbmpUnchecked;
  DWORD   dwItemData;
  CHAR    szString[IMEMENUITEM_STRING_SIZE];
  HBITMAP hbmpItem;
} IMEMENUITEMINFOA, *PIMEMENUITEMINFOA, *NPIMEMENUITEMINFOA, *LPIMEMENUITEMINFOA;

Члены

cbSize

Размер структуры в байтах.

fType

Тип элемента меню. Этот элемент может иметь одно из следующих значений.

Ценность	Значение
IMFT_RADIOCCHECK	Отображение флажков меню с помощью переключателя вместо флажка, если элемент hbmpCheckedNULL.
IMFT_SEPARATOR	Элемент меню — это разделитель. Разделитель элементов меню отображается как горизонтальная разделительная линия. В этом случае элементы hbmpItem и szString игнорируются.
IMFT_SUBMENU	Элемент меню — это подменю.

fState

Состояние элемента меню. Этот член может иметь одно или несколько следующих значений:

Ценность	Значение
IMFS_CHECKED	Проверяется элемент меню. Дополнительные сведения см. в описании элемента hbmpChecked.
IMFS_DEFAULT	Элемент меню по умолчанию. Меню может содержать только один элемент меню по умолчанию, который отображается полужирным шрифтом.
IMFS_DISABLED	Элемент меню отключен и отображается неактивным, поэтому его нельзя выбрать. Это эквивалентно IMFS_GRAYED.
IMFS_ENABLED	Элемент меню включен. Это состояние по умолчанию.
IMFS_GRAYED	Элемент меню отключен и отображается неактивным, поэтому его нельзя выбрать. Это эквивалентно IMFS_DISABLED.
IMFS_HILITE	Выделен элемент меню.
IMFS_UNCHECKED	Элемент меню снят. Дополнительные сведения о элементах меню без флажка см. в описании элемента hbmpUnchecked.
IMFS_UNHILITE	Элемент меню не выделен. Это состояние по умолчанию.

wID

Определяемое приложением 16-разрядное значение, определяющее элемент меню.

hbmpChecked

Обработайте растровое изображение, чтобы отобразить рядом с элементом, если он установлен. Если этот элемент null, используется растровое изображение по умолчанию. Если задано значение типа IMFT_RADIOCHECK, то по умолчанию точечный рисунок является маркером. В противном случае это флажок.

hbmpUnchecked

Обработайте растровое изображение, чтобы отобразить рядом с элементом, если он не установлен. Если этот элемент NULL, то растровое изображение не используется.

dwItemData

Определяемое приложением значение, связанное с элементом меню.

szString[IMEMENUITEM_STRING_SIZE]

Содержимое элемента меню. Это строка, завершающаяся значением NULL.

hbmpItem

Дескриптор для отображения растрового изображения.

Замечания

Заметка

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

Требования

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

См. также

ImmGetImeMenuItems

диспетчера методов ввода

Структуры диспетчера методов ввода

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