Функция AppendMenuA (winuser.h)

Статья
08/27/2023

Добавляет новый элемент в конец указанной строки меню, раскрывающегося меню, подменю или контекстного меню. Эту функцию можно использовать для указания содержимого, внешнего вида и поведения элемента меню.

Синтаксис

BOOL AppendMenuA(
  [in]           HMENU    hMenu,
  [in]           UINT     uFlags,
  [in]           UINT_PTR uIDNewItem,
  [in, optional] LPCSTR   lpNewItem
);

Параметры

[in] hMenu

Тип: HMENU

Дескриптор строки меню, раскрывающегося меню, подменю или контекстного меню для изменения.

[in] uFlags

Тип: UINT

Управляет внешним видом и поведением нового пункта меню. Этот параметр может быть сочетанием следующих значений.

Значение	Значение
MF_BITMAP 0x00000004L	Использует точечный рисунок в качестве пункта меню. Параметр lpNewItem содержит дескриптор растрового изображения.
MF_CHECKED 0x00000008L	Помещает проверка метку рядом с пунктом меню. Если приложение предоставляет растровые изображения проверка метки (см. раздел SetMenuItemBitmaps), этот флаг отображает растровое изображение проверка метки рядом с элементом меню.
MF_DISABLED 0x00000002L	Отключает пункт меню, чтобы его нельзя было выбрать, но флаг не будет серым.
MF_ENABLED 0x00000000L	Включает пункт меню, чтобы его можно было выбрать, и восстанавливает его из серого состояния.
MF_GRAYED 0x00000001L	Отключает элемент меню и выделяет его серым цветом, чтобы его нельзя было выбрать.
MF_MENUBARBREAK 0x00000020L	Работает так же, как и флаг MF_MENUBREAK для строки меню. Для раскрывающегося меню, подменю или контекстного меню новый столбец отделяется от старого столбца вертикальной линией.
MF_MENUBREAK 0x00000040L	Помещает элемент в новую строку (для строки меню) или в новый столбец (для раскрывающегося меню, подменю или контекстного меню) без разделения столбцов.
MF_OWNERDRAW 0x00000100L	Указывает, что элемент является элементом, нарисованным владельцем. Перед отображением меню в первый раз окно, которому принадлежит меню, получает WM_MEASUREITEM сообщение для получения ширины и высоты пункта меню. Сообщение WM_DRAWITEM затем отправляется в процедуру окна владельца всякий раз, когда необходимо обновить внешний вид пункта меню.
MF_POPUP 0x00000010L	Указывает, что пункт меню открывает раскрывающееся меню или подменю. Параметр uIDNewItem указывает дескриптор раскрывающегося меню или подменю. Этот флаг используется для добавления имени меню в строку меню или пункта меню, который открывает подменю в раскрывающемся меню, подменю или контекстном меню.
MF_SEPARATOR 0x00000800L	Рисует горизонтальную разделительную линию. Этот флаг используется только в раскрывающемся меню, подменю или контекстном меню. Линия не может быть серой, отключенной или выделенной. Параметры lpNewItem и uIDNewItem игнорируются.
MF_STRING 0x00000000L	Указывает, что элемент меню является текстовой строкой; Параметр lpNewItem является указателем на строку.
MF_UNCHECKED 0x00000000L	Не помещать проверка метку рядом с элементом (по умолчанию). Если приложение предоставляет проверка растровые изображения (см. раздел SetMenuItemBitmaps), этот флаг отображает чистое растровое изображение рядом с элементом меню.

[in] uIDNewItem

Тип: UINT_PTR

Идентификатор нового пункта меню или, если параметру uFlags присвоено значение MF_POPUP, дескриптор раскрывающегося меню или подменю.

[in, optional] lpNewItem

Тип: LPCTSTR

Содержимое нового пункта меню. Интерпретация lpNewItem зависит от того, включает ли параметр uFlags следующие значения.

Значение	Значение
MF_BITMAP 0x00000004L	Содержит дескриптор растрового рисунка.
MF_OWNERDRAW 0x00000100L	Содержит предоставленное приложением значение, которое можно использовать для хранения дополнительных данных, связанных с элементом меню. Значение находится в элементе itemData структуры, на которую указывает параметр lParamWM_MEASUREITEM или WM_DRAWITEM сообщения, отправленного при создании меню или обновлении его внешнего вида.
MF_STRING 0x00000000L	Содержит указатель на строку, завершаемую null.

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение. Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Чтобы ускорители клавиатуры работали с элементами меню с растровым рисунком или владельцем, владелец меню должен обработать WM_MENUCHAR сообщение. Дополнительные сведения см. в разделах Меню, нарисованные владельцем, и сообщение WM_MENUCHAR.

Следующие группы флагов нельзя использовать вместе:

MF_BITMAP, MF_STRING и MF_OWNERDRAW
MF_CHECKED и MF_UNCHECKED
MF_DISABLED, MF_ENABLED и MF_GRAYED
MF_MENUBARBREAK и MF_MENUBREAK

Примеры

Пример см. в разделе Добавление линий и графиков в меню.

Примечание

Заголовок winuser.h определяет AppendMenu как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-menu-l1-1-0 (представлено в Windows 8)