共用方式為


IAgentCommand

[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,您也會定義 CaptionVoice 設定,以取得其相關聯 Commands 集合。 如果一組命令的 Commands 集合沒有 Voice 或沒有 Caption 設定,且目前為輸入作用中, 但是 命令 具有 CaptionVoice 設定,命令 出現在 [語音命令視窗] 樹視圖的 [未定義命令] 底下,當用戶端應用程式變成輸入作用中時。

當伺服器收到符合您為 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 物件的識別碼。