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