IAgentCommand

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンのWindowsでは使用できない場合があります。

Command オブジェクトは、Commands コレクション内の項目です。 サーバーは、クライアント アプリケーションが入力アクティブになるコマンドへのユーザー アクセスを提供します。 コマンドを取得するには、IAgentCommands::GetCommand を呼び出します。

IAgentCommand は、アプリケーションが文字のポップアップ メニューや [音声コマンド] ウィンドウに表示できる Command オブジェクトのプロパティを設定およびクエリできるようにするインターフェイスを定義します。 これらの関数は 、IAgentCommandEx からも使用できます。 Command オブジェクトは、Commands コレクション内の項目です。 サーバーは、クライアント アプリケーションが入力がアクティブになったときに、コマンドへのユーザー アクセスを提供します。

コマンドは、キャラクターのポップアップメニューと音声コマンドウィンドウの両方または両方に表示されます。 ポップアップ メニューに表示するには、 キャプション があり、 Visible プロパティが True に設定されている必要があります。 クライアント アプリケーションが入力アクティブな場合にポップアップ メニューにコマンドを表示するには、その Commands コレクション オブジェクトの Visible プロパティも True に設定する必要があります。 [音声コマンド] ウィンドウに表示するには、 コマンド の VoiceCaption プロパティと Voice プロパティが設定されている必要があります。 (下位互換性のために、 VoiceCaption がない場合は、 キャプション 設定が使用されます)。

メニューが表示されている間、文字のポップアップ メニュー エントリは変更されません。 文字のポップアップ メニューが表示されているときにコマンドを追加または削除したり、プロパティを変更したりすると、再表示時にメニューにそれらの変更が表示されます。 ただし、[音声コマンド] ウィンドウには変更が表示されます。

次の表は、コマンドのプロパティがプレゼンテーションにどのように影響するかをまとめたものです。

Caption プロパティ	Voice-Caption プロパティ	Voice プロパティ	Visible プロパティ	キャラクターのポップアップメニューに表示される	[音声コマンド] ウィンドウに表示される
はい	はい	はい	はい	はい(キャプションを使用)	はい(VoiceCaption を使用)
はい	はい	No¹	はい	はい(キャプションを使用)	いいえ
はい	はい	はい	False	いいえ	はい(VoiceCaption を使用)
はい	はい	No¹	False	いいえ	いいえ
No¹	はい	はい	True	いいえ	はい(VoiceCaption を使用)
No¹	はい	はい	False	いいえ	はい(VoiceCaption を使用)
No¹	はい	No¹	True	いいえ	いいえ
No¹	はい	No¹	False	いいえ	いいえ
はい	No¹	はい	はい	はい(キャプションを使用)	はい(キャプションを使用)
はい	No¹	No¹	True	はい	いいえ
はい	No¹	はい	False	いいえ	はい(キャプションを使用)
はい	No¹	No¹	False	いいえ	いいえ
No¹	No¹	はい	True	いいえ	いいえ²
No¹	No¹	はい	False	いいえ	いいえ²
No¹	No¹	No¹	True	いいえ	いいえ
No¹	No¹	No¹	False	いいえ	いいえ

 

¹ プロパティ設定が null の場合。 一部のプログラミング言語では、空の文字列が null 文字列と同じとは解釈されない場合があります。

²コマンドは引き続き音声でアクセスできます。

一般に、音声設定を使用してコマンドを定義する場合は、関連する Commands コレクションのキャプションと音声の設定も定義します。 一連のコマンドの Commands コレクションに 音声 または キャプション の設定がなく、現在入力アクティブであるのに、 コマンド に キャプション と 音声 の設定がある場合、クライアント アプリケーションが入力アクティブになると、[音声コマンド] ウィンドウツリー ビューの [(未定義のコマンド)]にコマンド が表示されます 。

サーバーは、Commands コレクションに対して定義した Command オブジェクトのいずれかに一致する入力を受け取ると、IAgentNotifySink::Command イベントを送信し、コマンドの ID を IAgentUserInput オブジェクトの属性として返します。 その後、条件ステートメントを使用して、コマンドの照合と処理を行うことができます。

Vtable 順序のメソッド

IAgentCommand メソッド	説明
SetCaption	Command オブジェクトの Caption の値を設定します。
GetCaption	Command オブジェクトの Caption プロパティの値を返します。
SetVoice	Command オブジェクトの音声テキストの値を設定します。
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 オブジェクトの ID を返します。