IAgentCommandsEx::InsertEx

[从 Windows 7 开始,Microsoft代理已弃用,在后续版本的 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,指定为 命令显示的 标题 文本的值。

bszVoice

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

bszVoiceCaption

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

bEnabled

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

bVisible

一个布尔表达式,指定 命令可见 设置。 如果参数 True,则 命令 将显示在字符的弹出菜单中(如果还设置了 Caption 属性)。

ulHelpID

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

dwRefID

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

dBefore

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

pdwID

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

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

另请参阅

IAgentCommandsEx::AddExIAgentCommandsEx::SetHelpContextIDIAgentCommands::AddIAgentCommands::RemoveIAgentCommands::RemoveAll