MENUITEMINFO

MENUITEMINFO структура содержит сведения о меню.

typedef struct tagMENUITEMINFO {}
    UINT cbSize; 
    UINT fMask; 
    UINT fType; 
    UINT fState; 
    UINT УЖР; 
    HMENU hSubMenu; 
    HBITMAP hbmpChecked; 
    HBITMAP hbmpUnchecked; 
    DWORD dwItemData; 
    LPTSTR dwTypeData; 
    UINT ККЗ; 
} MENUITEMINFO, ДАЛЕКО * LPMENUITEMINFO 
 

Члены

cbSize
Размер структуры в байтах.
fMask
Члены требуется получить или задать. Этот член может быть одно или несколько из следующих значений:
Значение Значение
MIIM_CHECKMARKS Извлекает или задает преобразование hbmpChecked и hbmpUnchecked члены.
MIIM_DATA Извлекает или задает преобразование dwItemData член.
MIIM_ID Возвращает или задает член УЖР.
MIIM_STATE Извлекает или задает преобразование fState член.
MIIM_SUBMENU Извлекает или задает преобразование hSubMenu член.
MIIM_TYPE Извлекает или задает fType и dwTypeData члены.

команда fType
Тип элемента меню. Этот член может быть одно или несколько из следующих значений:
Значение Значение
MFT_BITMAP Отображает элемент меню, с помощью точечного рисунка. Младший слово dwTypeData — членов является дескриптор точечного рисунка, и членов ККЗ игнорируется.
MFT_MENUBARBREAK Помещает элемент меню на новой линии (для строки меню) или в новой колонке (для раскрывающегося меню, вложенного меню или контекстное меню). Для меню, вложенного меню или контекстное меню вертикальная линия отделяет новый столбец из старого.
MFT_MENUBREAK Помещает элемент меню на новой линии (для строки меню) или в новой колонке (для раскрывающегося меню, вложенного меню или контекстное меню). Раскрывающееся меню, вложенного меню или контекстное меню столбцы не разделяются вертикальной линией.
MFT_OWNERDRAW Возложена ответственность за разработку элемент меню Окно, которому принадлежит меню. Окно получает сообщение WM_MEASUREITEM перед отображением меню в первый раз и WM_DRAWITEM сообщение всякий раз, когда необходимо обновить внешний вид элемента меню. Если указано это значение, член dwTypeData содержит определенное приложением-32-разрядное значение.
MFT_RADIOCHECK Отображает проверены, пункты меню, с помощью радио кнопки пометить вместо того, чтобы флажок Если член hbmpChecked имеет значение NULL.
MFT_RIGHTJUSTIFY Право, оправдывает пункта меню и любых последующих элементов. Это значение допустимо, только если элемент меню в строку меню.
MFT_RIGHTORDER Windows 95, Windows NT 5.0 и более поздних:Указывает, что меню Каскад справа налево (по умолчанию — слева направо). Это используется для поддержки языков справа налево, например арабский и иврит. `
MFT_SEPARATOR Указывает, что элемент меню разделитель. Сепаратор пункт меню отображается в виде горизонтальной разделительной линии. DwTypeData и ККЗ игнорируются. Это значение допустимо только в раскрывающемся меню, вложенного меню или контекстное меню.
MFT_STRING Отображает текстовую строку с помощью пункта меню. Член dwTypeData — указатель на ограниченную значением null строку, и членов ККЗ является длина строки.

Значения MFT_BITMAP, MFT_SEPARATOR и MFT_STRING не могут быть объединены друг с другом.

fState
Состояние элемента меню. Этот член может быть одно или несколько из следующих значений:
Значение Значение
MFS_CHECKED Проверяет элемент меню. Для получения дополнительных сведений о зарегистрированном команды меню см hbmpChecked член.
MFS_DEFAULT Указывает, что пункт меню по умолчанию. Меню может содержать только один пункт меню по умолчанию, который отображается полужирным шрифтом.
MFS_DISABLED Отключает элемент меню таким образом, чтобы он не может быть выбран, но не Грэй.
MFS_ENABLED Разрешает пункт меню, так что он может быть выбран. Это состояние по умолчанию.
MFS_GRAYED Отключает элемент меню и grays, так что он не может быть выбран.
MFS_HILITE Выделяет элемент меню.
MFS_UNCHECKED Снятии флажка элемента меню. Для получения дополнительных сведений о неконтролируемого команды меню см hbmpUnchecked член.
MFS_UNHILITE Удаляет выделение из пункта меню. Это состояние по умолчанию.

wID
Приложением-16-разрядное значение, идентифицирующее элемент меню.
hSubMenu
Дескриптор меню или подменю, связанный с пунктом меню. Если пункт меню не является элемент, который открывает раскрывающееся меню или подменю, этот элемент имеет значение NULL.
hbmpChecked
Дескриптор точечного рисунка для отображения рядом с элементом, если он установлен. Если этот элемент имеет значение NULL, используется по умолчанию точечный рисунок. Если задано значение типа MFT_RADIOCHECK, по умолчанию точечный рисунок является пуля. В противном случае это флажок.
hbmpUnchecked
Дескриптор точечного рисунка для отображения рядом с элементом, если он не установлен. Если этот элемент имеет значение NULL, используется не рисунок.
dwItemData
Определенное приложением значение, связанное с пунктом меню.
dwTypeData
Содержание пункта меню. Этот член используется, только если флаг MIIM_TYPE установлен в fMask член.

Перед вызовом GetMenuItemInfo, приложение должно установить этот член на буфер, длина которого определяется членов ККЗ. Если пункт меню полученного типа MFT_STRING, то GetMenuItemInfo копирует текст пункта меню в буфер. Если элемент полученного меню имеет другой тип, то GetMenuItemInfo задает член dwTypeData в значение, тип которого определяется fType член.

При использовании вместе с функцией SetMenuItemInfo , этот элемент содержит значение, тип которого определяется fType член.

ккз
Длина текста пункта меню при получении информации о пункт меню MFT_STRING типа. Этот член используется, только если флаг MIIM_TYPE установлен в fMask -членов и в противном случае равно нулю. Этот элемент игнорируется, когда содержание пункта меню имеет значение путем вызова SetMenuItemInfo.

Перед вызовом GetMenuItemInfo, приложение должно установить этот член длиной буфера, который указывает dwTypeData член. Если пункт меню полученного типа MFT_STRING (как указывается команда fType членом), GetMenuItemInfo устанавливает для ККЗ длину полученные строки. Если пункт меню полученного от другого типа, GetMenuItemInfo устанавливает ККЗ поля до нуля.

Примечания

Структура MENUITEMINFO используется с функциями GetMenuItemInfo, InsertMenuItemи SetMenuItemInfo.

QuickInfo

nbsp; Windows &NT: требует версии 4.0 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в winuser.h.
Юникод:Определяется как структуры Unicode и ANSI.

Родственные слова

Обзор меню, структуры меню, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM