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 true。 FALSE 返回指示 lpOleObjNULL 并创建了禁用的默认菜单项。

言论

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

注意

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

要求

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