[Microsoft代理程式從 Windows 7 開始已被取代，而且可能無法在後續版本的 Windows 中使用。]
-
描述
-
在 Commands 集合中插入 Command 物件。
-
語法
-
代理程式**。字元 （“CharacterID]。Commands.Insert** Name、RefName、Before_
Caption、Voice、Enabled、Visible
部分 描述 名稱 必填。 字串值，對應至您指派給 Command的標識符。 RefName 必填。 對應至命令名稱（ID）的字串值，正上方或下方您想要插入新命令。 之前 自選。 布爾值，指出是否要在 RefName所指定的命令之前插入新命令。 True （預設值）。 新的命令將會在參考的命令之前插入。
False 新的命令將會插入參考的命令之後。Caption 自選。 字串值，對應至字元彈出視窗中，以及當用戶端應用程式為輸入作用中時，會出現在 [命令視窗] 中的名稱。 如需詳細資訊，請參閱 Command 物件的 Caption屬性。 語音 自選。 對應至語音引擎用來辨識此命令之單字或片語的字串值。 如需設定字串替代格式的詳細資訊，請參閱 Command 物件的 Voice 屬性。 已啟用 自選。 布爾值，指出是否啟用命令。 預設值為 true 。 如需詳細資訊，請參閱 Command 物件的 Enabled 屬性。 可見 自選。 布爾值，指出當用戶端應用程式為輸入作用中時，命令是否顯示在命令視窗中。 預設值為 true 。 如需詳細資訊，請參閱 Command 物件的 Visible 屬性。
言論
Command 物件的 Name 屬性的值在其 Commands 集合中必須是唯一的。 您必須先移除 Command，才能使用相同的 Name 屬性設定來建立新的 Command。 嘗試使用已經存在 Name 屬性建立 Command 會產生錯誤。
這個方法也會傳回 Command 物件。 這可讓您宣告 物件，並在呼叫 Insert 方法時，將 Command 指派給它。
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"