AppendMenuW 函数 (winuser.h)

将新项追加到指定菜单栏、下拉菜单、子菜单或快捷菜单的末尾。 可以使用此函数指定菜单项的内容、外观和行为。

语法

BOOL AppendMenuW(
  [in]           HMENU    hMenu,
  [in]           UINT     uFlags,
  [in]           UINT_PTR uIDNewItem,
  [in, optional] LPCWSTR  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
绘制一条水平分割线。 此标志仅在下拉菜单、子菜单或快捷菜单中使用。 行不能灰显、禁用或突出显示。 忽略 lpNewItemuIDNewItem 参数。
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
包含应用程序提供的值,该值可用于维护与菜单项相关的其他数据。 该值位于在创建菜单或更新其外观时发送的WM_MEASUREITEMWM_DRAWITEM消息的 lParam 参数指向的 结构的 itemData 成员中。
MF_STRING
0x00000000L
包含指向以 null 结尾的字符串的指针。

返回值

类型: BOOL

如果该函数成功,则返回值为非零值。 如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。

注解

无论菜单是否在显示的窗口中,只要菜单发生更改,应用程序都必须调用 DrawMenuBar 函数。

若要使键盘快捷键处理位图或所有者绘制的菜单项,菜单所有者必须处理 WM_MENUCHAR 消息。 有关详细信息,请参阅 所有者绘制的菜单和WM_MENUCHAR消息

以下标志组不能一起使用:

  • MF_BITMAPMF_STRINGMF_OWNERDRAW
  • MF_CHECKEDMF_UNCHECKED
  • MF_DISABLEDMF_ENABLEDMF_GRAYED
  • MF_MENUBARBREAKMF_MENUBREAK

示例

有关示例,请参阅 向菜单添加线条和图形

注意

winuser.h 标头将 AppendMenu 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 windows 8) 中引入的 ext-ms-win-ntuser-menu-l1-1-0 (

请参阅

概念性

CreateMenu

DeleteMenu

DestroyMenu

DrawMenuBar

InsertMenu

InsertMenuItem

菜单

ModifyMenu

引用

RemoveMenu

SetMenuItemBitmaps