[Microsoft代理程式從 Windows 7 開始已被取代,而且可能無法在後續版本的 Windows 中使用。]
Command 物件是 Commands 集合中的專案。 伺服器可讓使用者存取用戶端應用程式變成使用中輸入的命令。 若要擷取 命令,請呼叫 IAgentCommands::GetCommand。
IAgentCommand 會定義介面,讓應用程式能夠設定和查詢 Command 物件的屬性,這些物件可以出現在字元的快捷功能表和語音命令視窗中。 這些函式也可從 IAgentCommandEx取得。 Command 物件是 Commands 集合中的專案。 當用戶端應用程式變成使用中輸入時,伺服器會提供使用者對命令的存取權。
命令 可能會出現在字元的彈出視窗和語音命令視窗中。 若要出現在彈出視窗中,它必須具有 Caption,並且將 Visible 屬性設定為 True。 Commands 集合物件的 Visible 屬性也必須設定為 true True,當用戶端應用程式為輸入作用中時,命令會出現在彈出視窗中。 若要出現在 [語音命令] 視窗中,命令 必須設定其 VoiceCaption,並設定 Voice 属性。 (為了回溯相容性,如果沒有 VoiceCaption,則會使用 Caption 設定。
顯示功能表時,字元的快捷功能表項不會變更。 如果您在顯示字元的快捷功能表時新增或移除命令或變更其屬性,功能表會在重新顯示時顯示這些變更。 不過,語音命令視窗會在您進行變更時顯示變更。
下表摘要說明命令的屬性如何影響其呈現方式。
| Caption 屬性 | Voice-Caption 屬性 | Voice 屬性 | Visible 屬性 | 出現在字元的快捷功能表中 | 出現在語音命令視窗中 |
|---|---|---|---|---|---|
| 是的 | 是的 | 是的 | 真 | 是,使用 Caption | 是,使用 VoiceCaption |
| 是的 | 是的 | 否 2012 | 真 | 是,使用 Caption | 不 |
| 是的 | 是的 | 是的 | 假 | 不 | 是,使用 VoiceCaption |
| 是的 | 是的 | 否 2012 | 假 | 不 | 不 |
| 否 2012 | 是的 | 是的 | 真 | 不 | 是,使用 VoiceCaption |
| 否 2012 | 是的 | 是的 | 假 | 不 | 是,使用 VoiceCaption |
| 否 2012 | 是的 | 否 2012 | 真 | 不 | 不 |
| 否 2012 | 是的 | 否 2012 | 假 | 不 | 不 |
| 是的 | 否 2012 | 是的 | 真 | 是,使用 Caption | 是,使用 Caption |
| 是的 | 否 2012 | 否 2012 | 真 | 是的 | 不 |
| 是的 | 否 2012 | 是的 | 假 | 不 | 是,使用 Caption |
| 是的 | 否 2012 | 否 2012 | 假 | 不 | 不 |
| 否 2012 | 否 2012 | 是的 | 真 | 不 | 否 2012 |
| 否 2012 | 否 2012 | 是的 | 假 | 不 | 否 2012 |
| 否 2012 | 否 2012 | 否 2012 | 真 | 不 | 不 |
| 否 2012 | 否 2012 | 否 2012 | 假 | 不 | 不 |
2 如果屬性設定為 null。 在某些程式設計語言中,空字串可能不會解譯為與 Null 字串相同的字串。
超音命令仍可供語音存取。
一般而言,如果您使用 Voice 設定來定義 Command,您也會定義 Caption 和 Voice 設定,以取得其相關聯 Commands 集合。 如果一組命令的 Commands 集合沒有 Voice 或沒有 Caption 設定,且目前為輸入作用中, 但是 命令 具有 Caption 和 Voice 設定,命令 出現在 [語音命令視窗] 樹視圖的 [未定義命令] 底下,當用戶端應用程式變成輸入作用中時。
當伺服器收到符合您為 Commands 集合定義的其中一個 Command 物件的輸入時,它會傳送 IAgentNotifySink::Command 事件,並將命令的標識符傳回為 IAgentUserInput 物件的屬性。 然後,您可以使用條件語句來比對和處理命令。
以 Vtable 順序 方法
| IAgentCommand 方法 | 描述 |
|---|---|
| SetCaption | 設定 Command 物件的 Caption 值。 |
| GetCaption | 傳回 Command 物件的 Caption 屬性值。 |
| SetVoice | 設定 Command 物件的 Voice 文字值。 |
| GetVoice | 傳回 Command 物件的 Voice 屬性值。 |
| SetEnabled | 設定 Command 物件的 Enabled 屬性值。 |
| GetEnabled | 傳回 Command 物件的 Enabled 屬性值。 |
| SetVisible | 設定 Command 物件的 Visible 屬性值。 |
| GetVisible | 傳回 Command 物件的 Visible 屬性值。 |
| SetConfidenceThreshold | 設定 Command 物件的 Confidence 屬性值。 |
| GetConfidenceThreshold | 傳回 Command 物件的 Confidence 屬性值。 |
| SetConfidenceText | 設定 Command 物件的 ConfidenceText 屬性值。 |
| getConfidenceText | 會傳回 Command 物件的 ConfidenceText 屬性值。 |
| getID | 傳回 Command 物件的識別碼。 |