Структура MENUITEMINFO

Извлекает или устанавливает члены. Этот член может состоять из одного или нескольких этих значений.

Значение	Предназначение
MIIM_BITMAP	Microsoft ® Windows ® 98/Windows Millennium Edition (Windows Me), Windows 2000/Windows XP: Извлекает или устанавливает член *hbmpItem*.
MIIM_CHECKMARKS	Извлекает или устанавливает члены *hbmpChecked* и *hbmpUnchecked*.
MIIM_DATA	Извлекает или устанавливает член *dwItemData*.
MIIM_FTYPE	Windows 98/Windows Me, Windows 2000/Windows XP: Извлекает или устанавливает член *fType*.
MIIM_ID	Извлекает или устанавливает член *wID*.
MIIM_STATE	Извлекает или устанавливает член *fState*.
MIIM_STRING	Windows 98/Windows Me, Windows 2000/Windows XP: Извлекает или устанавливает член *dwTypeData*.
MIIM_SUBMENU	Извлекает или устанавливает член *hSubMenu*.
MIIM_TYPE	Извлекает или устанавливает члены *fType* и *dwTypeData. Windows 98/Me, Windows 2000/XP: MIIM_TYPE* заменяется MIIM_BITMAP, MIIM_FTYPE и MIIM_STRING.

fType

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

Значения MFT_BITMAP, MFT_SEPARATOR и MFT_STRING не могут быть объединены друг с другом. Чтобы использовать параметр fType, установите fMask в MIIM_TYPE.

Windows 98/Me и Windows 2000/XP: fType используется только в том случае, если fMask имеет значение MIIM_FTYPE.

Значение	Предназначение
MFT_BITMAP	Показывает на экране пункт меню, используя точечный рисунок (значок). Младшее слово члена *dwTypeData* - дескриптор значка, а член *cch* игнорируется. Windows 98/Me, Windows 2000/XP: MFT_BITMAP замещается флажком MIIM_BITMAP и *hbmpItem*.
MFT_MENUBARBREAK	Помещает пункт меню в новую строку (для строки меню) или в новом столбце (для "выпадающего" меню, подменю или контекстного меню). Для "выпадающего" меню, подменю или контекстного меню, вертикальная линия отделяет новый столбец от старого.
MFT_MENUBREAK	Помещает пункт меню в новую строку (для строки меню) или в новом столбце (для "выпадающего" меню, подменю или контекстного меню). Для "выпадающего" меню, подменю или контекстного меню, столбцы не отделяются вертикальной линией.
MFT_OWNERDRAW	Назначает ответственного за рисование пункта меню в окне, которое владеет меню. Окно получает сообщение WM_MEASUREITEM прежде, чем меню впервые отображается и сообщение WM_DRAWITEM всякий раз, когда внешний вид пункта меню должен быть модифицирован. Если это значение устанавливается, член *dwTypeData* содержит определяемое программой значение.
MFT_RADIOCHECK	Выводит на экран выбор пунктов меню, используя метку радио-кнопки вместо "галочки", если член *hbmpChecked* имеет значение ПУСТО (NULL).
MFT_RIGHTJUSTIFY	Выравнивает по правой стороне пункт меню и любые последующие пункты. Это значение допустимо только тогда, если пункт меню находится в строке меню.
MFT_RIGHTORDER	Windows 95/98/Me, Windows 2000/XP: Устанавливает, что ориентация каскада меню справа налево (значение по умолчанию - слева направо). Этот флажок используется для, поддержания ориентации справа налево в таких языках как арабский и еврейский язык.
MFT_SEPARATOR	Устанавливает разделитель пунктов меню. Разделитель пунктов меню выглядит как горизонтальная разделительная линия. Члены *DwTypeData* и *cch* игнорируются. Это значение допустимо только в "выпадающем" меню, подменю или контекстном меню.
MFT_STRING	Показывает на экране пункт меню, используя текстовую строку. Член *DwTypeData* - указатель на символьную строку с нулем в конце, а член *cch* - длина строки. Windows 98/Me, Windows 2000/XP: флажок MFT_STRING замещается MIIM_STRING.

fState

Состояние пункта меню. Этот член может состоять из одного или нескольких этих значений. Чтобы использовать fState, установите член fMask в MIIM_STATE, .

Значение	Предназначение
MFS_CHECKED	Отмечает "галочкой" пункт меню. Подробную информацию об выбранных пунктах меню, см. в описании члена *hbmpChecked* этой структуры.
MFS_DEFAULT	Устанавливает, что этот пункт меню - по умолчанию. Меню может содержать только один заданный по умолчанию пункт меню, который отображается на экране полужирным шрифтом.
MFS_DISABLED	Отключает пункт меню и окрашивает его в серый цвет (делает недоступным), чтобы он не мог быть выбран. Это эквивалент флажка MFS_GRAYED.
MFS_ENABLED	Включает в работу пункт меню, чтобы он мог быть выбран. Это - заданное по умолчанию состояние.
MFS_GRAYED	Запрещает работу пункта меню и окрашивает его в серый цвет (делает недоступным), чтобы он не мог выбираться. Этот флажок эквивалентен MFS_DISABLED.
MFS_HILITE	Выделяет пункт меню.
MFS_UNCHECKED	Снимает отметку "галочкой" пункта меню. Подробную информации об приведенных в исходное состояние пунктах меню, см. описание члена *hbmpChecked*.
MFS_UNHILITE	Удаляет выделение пункта меню. Это - заданное по умолчанию состояние.

wID
Определяемое программой 16-битовое значение, которое идентифицирует пункт меню. Чтобы использовать wID, установите член fMask в MIIM_ID.

hSubMenu

Дескриптор "выпадающего" меню или подменю, связанного с пунктом меню. Если пункт меню - не пункт, который открывает "выпадающее" меню или подменю, этот член равен ПУСТО (NULL). Чтобы использовать hSubMenu, установите член fMask в MIIM_SUBMENU.

hbmpChecked

Дескриптор точечного рисунка (значка), который показывается на экране рядом с пунктом, если он выбирается. Если этот член - значение ПУСТО (NULL), используется заданный по умолчанию значок . Если задается значение типа MFT_RADIOCHECK , заданный по умолчанию (типичный) точечный рисунок - жирная точка. В противном случае, это - галочка. Чтобы использовать hbmpChecked, установите член fMask в MIIM_CHECKMARKS.

hbmpUnchecked

Дескриптор точечного рисунка, который показывается на экране рядом с пунктом, если он не выбран. Если этот член - значение ПУСТО (NULL), точечный рисунок не используется. Чтобы использовать hbmpUnchecked, установите член fMask в MIIM_CHECKMARKS, .

dwItemData

Определяемое программой значение, связанное с пунктом меню. Чтобы использовать dwItemData, установите член fMask в MIIM_DATA.

dwTypeData

Содержание пункта меню. Значение этого члена зависит от значения fType, и используется только тогда, если в члене fMask установлен флажок MIIM_TYPE.

Чтобы извлечь пункт меню типа MFT_STRING, сначала найдите размер строки, устанавливая член dwTypeData структуры MENUITEMINFO в значение ПУСТО (NULL), а затем вызовите функцию GetMenuItemInfo. Значение cch+1 - необходимый размер. Затем выделите буфер этого размера, поместите указатель на буфер в член dwTypeData, увеличьте cch, и вызовите функцию GetMenuItemInfo еще раз, чтобы заполнить буфер строкой. Если извлеченный пункт меню имеет какой-либо другой тип, тогда GetMenuItemInfo устанавливает член dwTypeData в значение, тип которого определяется членом fType.

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

Windows 98/Me и Windows 2000/XP: dwTypeData используется только тогда, если флажок MIIM_STRING установлен в члене fMask .

cch

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

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

Windows 98/Me, Windows 2000/XP: член cch используется njulf, когда флажок MIIM_STRING - установлен в члене fMask .

hbmpItem

Windows 98/Me, Windows 2000/XP: Дескриптор точечного рисунка, который будет отображен, или этого может быть одним из значений в нижеследующей таблице. Этот член используется тогда, когда флажок MIIM_BITMAP - установлен в члене fMask.

Значение	Предназначение
HBMMENU_CALLBACK	Точечный рисунок рисуемый окном, которое владеет меню. Приложение должно обрабатывать сообщения WM_MEASUREITEM и WM_DRAWITEM .
HBMMENU_MBAR_CLOSE	Кнопка закрывающая строку меню.
HBMMENU_MBAR_CLOSE_D	Отключение кнопки, закрывающей строку меню.
HBMMENU_MBAR_MINIMIZE	Кнопка свертывания строки меню.
HBMMENU_MBAR_MINIMIZE_D	Отключение кнопки, свертывающей строку меню.
HBMMENU_MBAR_RESTORE	Кнопка восстановления строки меню.
HBMMENU_POPUP_CLOSE	Кнопка закрывающая подменю.
HBMMENU_POPUP_MAXIMIZE	Кнопка развертывающая подменю.
HBMMENU_POPUP_MINIMIZE	Кнопка свертывающая подменю.
HBMMENU_POPUP_RESTORE	Кнопка восстанавливающая подменю.
HBMMENU_SYSTEM	Значок Windows или значок окна, определяемого в члене *dwItemData*.

Замечания

Меню может использовать текст или точечные рисунки, но не оба.

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

Windows 98/Me и Windows 2000/XP: Меню может использовать текст или точечные рисунки, или оба.

Смотри также

Краткий обзор Меню, GetMenuItemInfo, InsertMenuItem, SetMenuItemInfo, WM_DRAWITEM, WM_MEASUREITEM

Размещение и совместимость MENUITEMINFO
Windows. NET Server	Да
Windows XP	Да
Windows 2000	Да
Windows NT	Да версии 4.0 и выше
Windows Me	Да
Windows 98	Да
Windows 95	Да
Импортируемая библиотека	-
Заголовочный файл
- объявлено в	Winuser.h
- включено в	Windows.h
Unicode	Нет
Замечания по платформе	Не имеется

Назад в оглавление

На главную страницу

На оглавление справки