AppendMenu-WIN32 API手册-惧留孙课堂

AppendMenu 函数

向菜单栏、下拉式菜单、子菜单或快捷菜单的尾部追加一个菜单项。可以用这个函数标识菜单项的内容、显示或行为。

函数原型：

BOOL AppendMenu ( HMENU hMenu,UINT uFlags,UINT_PTR uIDNewItem,LPCTSTR lpNewItem );

参数

hMenu

类型：HMENU

将被改变的菜单栏、下拉式菜单、子菜单或快捷菜单的句柄。

uFlags

类型：UINT

控制新菜单项的显示和行为。这个参数可以是下面值的组合：

宏	值	意义
MF_BITMAP	0x00000004L	使用位图作为菜单项。lpNewItem 参数包含位图的句柄。
MF_CHECKED	0x00000008L	在菜单项前打上选中标记。如果应用程序提供了可标记位图，这个标志使接下来的菜单项显示标记。
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	不在菜单前打上选中标志(默认)。如果程序提供了可标记位图，这个标志清除接下来的菜单项的位图。

uIDNewItem

类型：UINT_PTR

新菜单项的标志符，或者，如果参数 uFlags 被设置了 MF_POPUP 标志，来指定下拉式或子菜单的句柄。

lpNewItem

类型：LPCTSTR

新菜单项的内容。根据参数 uFlags 值不同，意义如下：

宏	值	意义
MF_BITMAP	0x00000004L	包含位图的句柄。
MF_OWNERDRAW	0x00000100L	包含程序提供的、与菜单项相关的额外信息的值。这个值是消息 WM_MEASUREITEM 或 WM_DRAWITEM 中被lParam参数指定的结构体中的itemData成员。
MF_STRING	0x00000000L	包含以空字符结尾的字符串指针。

返回值

类型：BOOL

如果成功，返回非0。
如果失败，返回 0。

支持

最低桌面系统支持	Windows 2000 Professional
头文件	Winuser.h (已包含在Windows.h中)
库	User32.lib
DLL	User32.dll
UNICODE版本名	AppendMenuW
ANSI版本名	AppendMenuA

作者:QQ:3304576112 交流QQ群：316930386 本站保留本页版权，可共享网址，匆复制内容

惧留孙网

AppendMenu 函数

参数

返回值

支持