Функция SetMenuItemInfo изменяет информацию о пункте меню.
Синтаксис
BOOL SetMenuItemInfo( HMENU hMenu, UINT uItem, BOOL fByPosition, LPMENUITEMINFO lpmii ); |
Параметры
hMenu
[in] Дескриптор меню, которое содержит пункт.uItem
[in] Идентификатор или позиция пункта меню, который измениться. Значение этого параметра зависит от значения fByPosition.fByPosition
[in] Значение, устанавливающее значение uItem. Если этот параметр - ЛОЖЬ (FALSE), uItem - идентификатор пункта меню. В противном случае, это - позиция пункта меню.lpmii
[in] Указатель на структуру MENUITEMINFO, которая содержит информацию о пункте меню и устанавливает, какому пункту меню изменять атрибуты.Возвращаемое значение
Если функция завершается успешно, величина возвращаемого значения - не нуль.
Если функция завершается ошибкой, величина возвращаемого значения - нуль. Чтобы получить дополнительные данные об ошибке, вызовите GetLastError.
Замечания
Приложение должно вызывать функцию DrawMenuBar всякий раз, когда изменяется меню, чтобы выявить действительно ли меню находится в отображаемом на экране окне.
Для ускорителей клавиатуры, чтобы работать с растровыми (значками) или нарисованными пользователем (собственными) пунктами меню, владелец меню должен обрабатывать сообщение WM_MENUCHAR. За подробной информацией обратитесь к статье Собственные меню и сообщение WM_MENUCHAR.
Windows 95/98/Me: SetMenuItemInfoW поддерживается программой Microsoft Layer for Unicode. Чтобы использовать ее, Вы должны добавить некоторые файлы к вашему приложению, как изложено в описании Microsoft Layer for Unicode для системы Windows 95/98/Me.
Пример
Пример смотри в статье Пример пунктов собственного меню.
Смотри также
Краткий обзор Меню, DrawMenuBar, GetMenuItemInfo, MENUITEMINFO|
Размещение и совместимость SetMenuItemInfo |
|
|
Windows. NET Server |
Да |
|
Windows XP |
Да |
|
Windows 2000 |
Да |
|
Windows NT |
Да версии 4.0 и выше |
|
Windows Me |
Да |
|
Windows 98 |
Да |
|
Windows 95 |
Да |
|
Используемая библиотека |
User32.lib |
|
Заголовочный файл |
|
|
- объявлено в |
Winuser.h |
|
- включено в |
Windows.h |
|
Unicode |
Нет |
|
Замечания по платформе |
Не имеется |