Структура MENUITEMINFOA (winuser.h)
Содержит сведения о элементе меню.
Синтаксис
typedef struct tagMENUITEMINFOA {
UINT cbSize;
UINT fMask;
UINT fType;
UINT fState;
UINT wID;
HMENU hSubMenu;
HBITMAP hbmpChecked;
HBITMAP hbmpUnchecked;
ULONG_PTR dwItemData;
LPSTR dwTypeData;
UINT cch;
HBITMAP hbmpItem;
} MENUITEMINFOA, *LPMENUITEMINFOA;
Члены
cbSize
Тип: UINT
Размер структуры в байтах. Вызывающий объект должен задать для этого элемента значение sizeof(MENUITEMINFO).
fMask
Тип: UINT
Указывает, что элементы, которые нужно получить или задать. Этот элемент может быть одним или несколькими из следующих значений.
fType
Тип: UINT
Тип элемента меню. Этот элемент может быть одним или несколькими из следующих значений.
Значения MFT_BITMAP, MFT_SEPARATORи MFT_STRING нельзя объединить друг с другом. Задайте
fType используется только в том случае, если fMask имеет значение MIIM_FTYPE.
| Ценность | Значение |
|---|---|
|
Отображает элемент меню с помощью растрового рисунка. Слово с низким порядком dwTypeData является дескриптором растрового изображения, а элемент cch игнорируется.
MFT_BITMAP заменяется MIIM_BITMAP и hbmpItem. |
|
Помещает пункт меню в новую строку (для строки меню) или в новом столбце (для раскрывающегося меню, подменю или контекстного меню). В раскрывающемся меню, подменю или контекстном меню вертикальная линия отделяет новый столбец от старого. |
|
Помещает пункт меню в новую строку (для строки меню) или в новом столбце (для раскрывающегося меню, подменю или контекстного меню). В раскрывающемся меню, подменю или контекстном меню столбцы не разделяются вертикальной линией. |
|
Назначает ответственность за рисование элемента меню в окне, владеющем меню. Окно получает сообщение WM_MEASUREITEM перед отображением меню в первый раз и WM_DRAWITEM сообщение при каждом появлении элемента меню. Если это значение указано, элемент dwTypeData |
|
Отображает выбранные пункты меню с помощью переключателя вместо флажка, если элемент hbmpCheckedNULL. |
|
Правой кнопкой оправдан элемент меню и все последующие элементы. Это значение допустимо, только если элемент меню находится в строке меню. |
|
Указывает, что меню каскада справа налево (по умолчанию — слева направо). Это используется для поддержки языков справа налево, таких как арабский и иврит. |
|
Указывает, что элемент меню является разделителем. Разделитель элементов меню отображается как горизонтальная разделительная линия. dwTypeData и элементов cch игнорируются. Это значение допустимо только в раскрывающемся меню, подменю или контекстном меню. |
|
Отображает элемент меню с помощью текстовой строки. Элемент dwTypeData — это указатель на строку, завершаемую значением NULL, а элемент cch — длину строки.
MFT_STRING заменяется MIIM_STRING. |
fState
Тип: UINT
Состояние элемента меню. Этот элемент может быть одним или несколькими из этих значений. Задайте MIIM_STATE для использования fState.
wID
Тип: UINT
Определяемое приложением значение, определяющее элемент меню. Задайте MIIM_ID использовать wID.
hSubMenu
Тип: HMENU
Дескриптор раскрывающегося меню или подменю, связанного с элементом меню. Если элемент меню не является элементом, который открывает раскрывающееся меню или подменю, этот элемент NULL. Задайте fMask значение MIIM_SUBMENU, чтобы использовать hSubMenu.
hbmpChecked
Тип: HBITMAP
Дескриптор растрового изображения, который будет отображаться рядом с элементом, если он выбран. Если этот элемент null, используется растровое изображение по умолчанию. Если задано значение типа MFT_RADIOCHECK, то по умолчанию используется точечный рисунок. В противном случае это флажок. Задайте fMask значение MIIM_CHECKMARKS для использования hbmpChecked.
hbmpUnchecked
Тип: HBITMAP
Дескриптор растрового изображения, который будет отображаться рядом с элементом, если он не выбран. Если этот элемент NULL, то растровое изображение не используется. Задайте MIIM_CHECKMARKS для использования hbmpUnchecked.
dwItemData
Тип: ULONG_PTR
Определенное приложением значение, связанное с элементом меню. Задайте для
dwTypeData
Тип: LPTSTR
Содержимое элемента меню. Значение этого элемента зависит от значения fType и используется только в том случае, если флаг MIIM_TYPE задан в элементе fMask.
Чтобы получить элемент меню типа
При использовании с функцией
dwTypeData используется только в том случае, если флаг MIIM_STRING задан в элементе fMask
cch
Тип: UINT
Длина текста элемента меню в символах при получении сведений о элементе меню типа MFT_STRING. Однако cch используется только в том случае, если флаг MIIM_TYPE задан в элементе fMask и равен нулю в противном случае. Кроме того, cch игнорируется при задании содержимого элемента меню путем вызова SetMenuItemInfo.
Обратите внимание, что перед вызовом
Элемент cch
hbmpItem
Тип: HBITMAP
Дескриптор отображаемого растрового изображения или может быть одним из значений в следующей таблице. Он используется при установке флага MIIM_BITMAP в элементе fMask.
| Ценность | Значение |
|---|---|
|
Растровое изображение, рисуемое окном, принадлежащим меню. Приложение должно обрабатывать WM_MEASUREITEM и WM_DRAWITEM сообщения. |
|
Кнопка "Закрыть" для строки меню. |
|
Отключена кнопка закрытия для строки меню. |
|
Кнопка "Свернуть" для строки меню. |
|
Кнопка "Свернуть" для строки меню отключена. |
|
Кнопка "Восстановить" в строке меню. |
|
Кнопка "Закрыть" для подменю. |
|
Кнопка "Развернуть" для подменю. |
|
Кнопка "Свернуть" для подменю. |
|
Кнопка "Восстановить" для подменю. |
|
Значок Windows или значок окна, указанного в dwItemData. |
Замечания
Структура MENUITEMINFO используется с функциями GetMenuItemInfo, InsertMenuItemи SetMenuItemInfo.
Меню может отображать элементы с помощью текста, растровых изображений или обоих элементов.
Заметка
Заголовок winuser.h определяет MENUITEMINFO в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| заголовка | winuser.h (включая Windows.h) |
См. также
концептуальные
меню
Справочник