Функция InsertMenuA (winuser.h)
Вставляет новый пункт меню в меню, перемещая другие элементы в меню.
Синтаксис
BOOL InsertMenuA(
[in] HMENU hMenu,
[in] UINT uPosition,
[in] UINT uFlags,
[in] UINT_PTR uIDNewItem,
[in, optional] LPCSTR lpNewItem
);
Параметры
[in] hMenu
Тип: HMENU
Дескриптор меню, который необходимо изменить.
[in] uPosition
Тип: UINT
Элемент меню, перед которым нужно вставить новый элемент меню, как определено параметром uFlags.
[in] uFlags
Тип: UINT
Управляет интерпретацией параметра uPosition и содержимого, внешнего вида и поведения нового элемента меню. Этот параметр должен содержать одно из следующих обязательных значений.
Параметр также должен содержать по крайней мере одно из следующих значений.
| Ценность | Значение |
|---|---|
|
Использует растровое изображение в качестве элемента меню. Параметр lpNewItem содержит дескриптор растрового изображения. |
|
Поместите флажок рядом с элементом меню. Если приложение предоставляет растровые изображения флажка (см. SetMenuItemBitmaps), этот флаг отображает растровое изображение флажка рядом с элементом меню. |
|
Отключает элемент меню, чтобы его нельзя было выбрать, но не серо. |
|
Включает элемент меню, чтобы его можно было выбрать и восстановить из его серого состояния. |
|
Отключает элемент меню и серый цвет, чтобы его нельзя было выбрать. |
|
Функции, аналогичные флагу MF_MENUBREAK для строки меню. В раскрывающемся меню, подменю или контекстном меню новый столбец отделяется от старого столбца вертикальной линией. |
|
Помещает элемент в новую строку (для строк меню) или в новом столбце (для раскрывающегося меню, подменю или контекстного меню) без разделения столбцов. |
|
Указывает, что элемент является элементом, нарисованным владельцем. Перед первым отображением меню окно, которое владеет меню, получает сообщение WM_MEASUREITEM для получения ширины и высоты элемента меню. Затем сообщение WM_DRAWITEM отправляется в процедуру окна владельца при каждом появлении элемента меню. |
|
Указывает, что элемент меню открывает раскрывающееся меню или подменю. Параметр |
|
Рисует горизонтальную линию деления. Этот флаг используется только в раскрывающемся меню, подменю или контекстном меню. Строка не может быть серой, отключенной или выделенной. Параметры lpNewItem и uIDNewItem игнорируются. |
|
Указывает, что элемент меню является текстовой строкой; параметр lpNewItem — это указатель на строку. |
|
Не помещать флажок рядом с элементом меню (по умолчанию). Если приложение предоставляет растровые изображения флажка (см. функцию SetMenuItemBitmaps ), этот флаг отображает четкое растровое изображение рядом с элементом меню. |
[in] uIDNewItem
Тип: UINT_PTR
Идентификатор нового элемента меню или, если параметр uFlags имеет набор флагов MF_POPUP, дескриптор раскрывающегося меню или подменю.
[in, optional] lpNewItem
Тип: LPCTSTR
Содержимое нового элемента меню. Интерпретация
| Ценность | Значение |
|---|---|
|
Содержит дескриптор растрового изображения. |
|
Содержит предоставленное приложением значение, которое можно использовать для поддержания дополнительных данных, связанных с элементом меню. Значение находится в элементе itemData структуры, на которую указывает параметр lParam сообщения WM_MEASUREITEM или WM_DRAWITEM, отправляемого при создании элемента меню или его появлении. |
|
Содержит указатель на строку, завершаемую значением NULL (по умолчанию). |
Возвращаемое значение
Тип: BOOL
Если функция выполнена успешно, возвращаемое значение ненулевое.
Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Приложение должно вызывать функцию DrawMenuBar всякий раз при изменении меню, находится ли меню в отображаемом окне.
Следующие группы флагов нельзя использовать вместе:
- MF_BYCOMMAND и MF_BYPOSITION
- MF_DISABLED, MF_ENABLEDи MF_GRAYED
- MF_BITMAP, MF_STRING, MF_OWNERDRAWи MF_SEPARATOR
- MF_MENUBARBREAK и MF_MENUBREAK
- MF_CHECKED и MF_UNCHECKED
Заметка
Заголовок winuser.h определяет InsertMenu как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winuser.h (включая Windows.h) |
| библиотеки |
User32.lib |
| DLL | User32.dll |
| набор API | ext-ms-win-ntuser-menu-l1-1-0 (представлено в Windows 8) |
См. также
концептуальные
меню
другие ресурсы
Справочник