[Now Supported on Windows NT]
将菜单项添加到指定的菜单。菜单项应插入菜单中的指定位置,菜单项标识符必须在给定范围内。
HRESULT QueryContextMenu
HMENU 【HMENU】, | //处理菜单 |
UINT 【indexMenu】, | //插入第一个菜单项的位置 |
UINT 【idCmdFirst】, | //菜单项标识符的最小值 |
UINT 【idCmdLast】, | //菜单项标识符的最大值 |
UINT 【uFlags】 | //指定零个或多个状态值 |
); |
参数
【HMENU】
处理菜单。调用InsertMenu或InsertMenuItem功能时,处理程序应指定此句柄。
【indexMenu】
基于零的位置插入第一个菜单项。
【idCmdFirst】
处理程序可以为菜单项标识符指定的最小值。
【idCmdLast】
处理程序可以为菜单项标识符指定的最大值。
【uFlags】
指定以下值的零个或多个:
CMF_DEFAULTONLY | 用户通常通过双击来激活默认操作。该值为上下文菜单提供了一个提示,如果它不修改菜单中的默认项,则不添加任何内容。如果指定了此值,则上下文菜单扩展或拖放处理程序不应添加任何菜单项。名称空间扩展名应该只添加默认项(如果有)。 |
CMF_EXPLORE | 上下文菜单处理程序应忽略此值。当资源管理器中的对象的上下文菜单是指定的。 |
CMF_NORMAL | 表示正常操作。上下文菜单扩展,名称空间扩展或拖放处理程序可以添加任何菜单项。 |
CMF_VERBSONLY | 上下文菜单处理程序应忽略此值。如果上下文菜单用于快捷方式对象,则指定此值。如果上下文菜单用于快捷方式对象,则指定此值。 |
低位字的剩余位由系统保留。高阶字可以用于上下文特定的通信。
返回值
返回HRESULT结构,其中如果方法成功,码成员包含添加的最后一个菜单项的菜单标识符偏移量加1。
注释
每个菜单项的实际标识应为【idCmdFirst】加上菜单标识符偏移量范围为零到(【idCmdLast】 - 【idCmdFirst】)。
也可以看看