IAgentCommandsEx：：InsertEx

  • 项目

[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 Windows 中不可用。]

HRESULT InsertEx(
   BSTR bszCaption,       // Caption setting for Command
   BSTR bszVoice,         // Voice setting for Command
   BSTR bszVoiceCaption,  // VoiceCaption setting for Command
   long bEnabled,         // Enabled setting for Command
   long bVisible,         // Visible setting for Command
   long ulHelpID,         // HelpContextID setting for Command
   long dwRefID,          // reference Command for insertion
   long dBefore,          // insertion position flag
   long * pdwID           // address for variable for Command ID
);

在 Commands 集合中插入 Command 对象。

  • 返回指示操作成功的S_OK。

bszCaption

一个 BSTR，指定为命令显示的 Caption 文本的值。

bszVoice

一个 BSTR，指定命令的语音文本设置的值。

bszVoiceCaption

一个 BSTR，指定为 Commands 集合中命令显示的 VoiceCaption 文本的值。

bEnabled

一个布尔表达式，指定命令的 Enabled 设置。 如果 参数为 True，则启用 命令 ，并且可以选择;如果 为 False，则禁用 命令 。

bVisible

一个布尔表达式，指定 Command 的 Visible 设置。 如果参数为 True，则 命令 将在角色的弹出菜单中可见， (如果 Caption 属性也设置为) 。

ulHelpID

与 Command 对象关联的帮助主题的上下文编号;用于为命令提供上下文相关的帮助。

dwRefID

用作新命令相对插入的引用的命令的 ID。

dBefore

一个布尔表达式，指定 放置命令的位置。 如果此参数为 True，则会在引用 的命令 之前插入新的 命令;如果 为 False，则新 命令 位于引用的 命令之后。

pdwID

接收所插入 命令的 ID 的变量的地址。

IAgentCommandsEx：：InsertEx 通过包含 HelpContextID 属性来扩展 IAgentCommands：：Insert。 还可以使用 IAgentCommandsEx：：SetHelpContextID 设置 属性

另请参阅

IAgentCommandsEx：：AddEx、 IAgentCommandsEx：：SetHelpContextID、 IAgentCommands：：Add、 IAgentCommands：：Remove、 IAgentCommands：：RemoveAll