Insert 方法

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

Description

在 Commands 集合中插入 Command 对象。

语法

agent**。字符 (“CharacterID”) 。Commands.Insert** Name， RefName， Before_

Caption、 Voice、Enabled、Visible

组成部分	说明
名称	必需。 与分配给 命令的 ID 对应的字符串值。
RefName	必需。 一个字符串值，该值对应于要插入新命令的正上方或下方的命令的名称 (ID) 。
之前	可选。 一个布尔值，指示是否在 RefName 指定的命令之前插入新命令。 True (默认) 。 新命令将插入到引用的命令之前。 假 新命令将插入到引用的命令之后。
Caption	可选。 与名称对应的字符串值，当客户端应用程序处于输入活动状态时，该名称将显示在字符的弹出菜单和命令窗口中。 有关详细信息，请参阅 Command 对象的 Caption属性。
语音	可选。 与语音引擎用于识别此命令的单词或短语对应的字符串值。 有关字符串的格式设置替代项的详细信息，请参阅 Command 对象的 Voice 属性。
已启用	可选。 一个布尔值，指示是否启用命令。 默认值为 True。 有关详细信息，请参阅 Command 对象的 Enabled 属性。
Visible	可选。 一个布尔值，指示客户端应用程序处于输入活动状态时命令是否在命令窗口中可见。 默认值为 True。 有关详细信息，请参阅 Command 对象的 Visible 属性。

备注

Command 对象的 Name 属性的值在其 Commands 集合中必须是唯一的。 必须先删除命令，然后才能创建具有相同名称属性设置的新命令。 尝试使用已存在的 Name 属性创建 Command 会引发错误。

此方法还返回 Command 对象。 这使你可以在调用 Insert 方法时声明对象并向其分配命令。

   Dim Cmd2 as IAgentCtlCommandEx
   Set Cmd2 = Genie.Commands.Insert ("my second command", "my first command",_ True, "Test", "Test", True, True)
   Cmd2.VoiceCaption = "this is a test"

另请参阅

Add 方法、 Remove 方法、 RemoveAll 方法