IAgentCommands：：Insert

  • 發行項

[從 Windows 7 開始，Microsoft Agent 已被取代，而且在後續版本的 Windows 中可能無法使用。]

HRESULT Insert(
   BSTR bszCaption,  // Caption setting for Command
   BSTR bszVoice,    // Voice setting for Command
   long bEnabled,    // Enabled setting for Command
   long bVisible,    // Visible 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，指定命令的語音文字設定值。

bEnabled

布林運算式，指定命令的Enabled設定。 如果參數為 True，則會啟用 命令 並加以選取;如果 為 False，則會停用 命令 。

bVisible

布林運算式，指定Command的Visible設定。 如果參數為True，則如果Caption 屬性也設定) ，則命令會顯示在字元的快顯功能表中 (。

dwRefID

做為新 命令 相對插入之參考的 命令識別碼。

dBefore

布林運算式，指定要放置 Command的位置。 如果此參數為 True，則會在參考的 命令 之前插入新的 Command;如果 為 False，則會在參考的 命令 之後放置新的 命令。

pdwID

接收所插入 命令識別碼的變數位址。

另請參閱

IAgentCommands：：Add、 IAgentCommands：：Remove、 IAgentCommands：：RemoveAll