OleUIAddVerbMenuW 函数 (oledlg.h)

将指定对象的 谓词 菜单添加到指定菜单。

语法

BOOL OleUIAddVerbMenuW(
  [in, optional] LPOLEOBJECT lpOleObj,
  [in, optional] LPCWSTR     lpszShortType,
  [in]           HMENU       hMenu,
  [in]           UINT        uPos,
  [in]           UINT        uIDVerbMin,
  [in]           UINT        uIDVerbMax,
  [in]           BOOL        bAddConvert,
  [in]           UINT        idConvert,
  [out]          HMENU       *lphMenu
);

参数

[in, optional] lpOleObj

指向所选对象上的 IOleObject 接口的指针。 如果这是 NULL，则创建默认的禁用菜单项。

[in, optional] lpszShortType

指向注册表中定义的短名称的指针， (AuxName==2) 为 lpOleObj 标识的对象。 如果字符串未知，则可能会传递 NULL 。 如果传递 NULL ，则调用 IOleObject：：GetUserType 来检索它。 如果调用方可以轻松访问该字符串，则传递字符串会更快。

[in] hMenu

要在其中进行修改的菜单的句柄。

[in] uPos

菜单项的位置。

[in] uIDVerbMin

要启动谓词的标识符值。

[in] uIDVerbMax

要用于对象谓词的最大标识符值。 如果 uIDVerbMax 为 0，则不使用最大标识符值。

[in] bAddConvert

指示是否将 “转换” 项添加到菜单底部 (前面有分隔符) 。

[in] idConvert

如果 bAddConvert 为 TRUE，则用于“转换”菜单项的标识符值。

[out] lphMenu

指向级联谓词菜单（如果已创建）的 HMENU 指针。 如果只有一个谓词，则用 NULL 填充此谓词。

返回值

如果 lpOleObj 有效且至少向菜单添加了一个谓词，则此函数返回 TRUE。 FALSE 返回指示 lpOleObj 为 NULL，并且已创建禁用的默认菜单项。

注解

如果 对象有一个谓词，则谓词将直接添加到给定菜单中。

注意

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

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	oledlg.h
Library	OleDlg.lib
DLL	OleDlg.dll