[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない可能性があります。]
Command オブジェクトは、Commands コレクション内の項目です。 サーバーは、クライアント アプリケーションが入力アクティブになるコマンドへのユーザー アクセスを提供します。 コマンドを取得するには、IAgentCommands::GetCommand呼び出します。
IAgentCommand は、アプリケーションが、文字のポップアップ メニューと音声コマンド ウィンドウに表示できる Command オブジェクトのプロパティを設定およびクエリできるようにするインターフェイスを定義します。 これらの関数は、IAgentCommandExからも使用できます。 Command オブジェクトは、Commands コレクション内の項目です。 サーバーは、クライアント アプリケーションが入力がアクティブになったときに、コマンドへのユーザー アクセスを提供します。
コマンド は、キャラクターのポップアップ メニューと音声コマンド ウィンドウの両方に表示される場合があります。 ポップアップ メニューに表示するには、キャプション があり、Visible プロパティが true に設定されている必要があります。 Commands コレクション オブジェクトの Visible プロパティは、クライアント アプリケーションが入力/アクティブのときにコマンドをポップアップ メニューに表示するには、True にも設定する必要があります。 [音声コマンド] ウィンドウに表示するには、コマンド の VoiceCaption プロパティと Voice プロパティが設定されている必要があります。 (下位互換性のために、VoiceCaption がない場合は、Caption 設定が使用されます)。
メニューが表示されている間、文字のポップアップ メニュー エントリは変更されません。 文字のポップアップ メニューが表示されているときにコマンドを追加または削除したり、プロパティを変更したりすると、再表示時にメニューにそれらの変更が表示されます。 ただし、[音声コマンド] ウィンドウでは、変更を行うと表示されます。
次の表は、コマンドのプロパティがプレゼンテーションにどのように影響するかをまとめたものです。
| Caption プロパティ | Voice-Caption プロパティ | Voice プロパティ | Visible プロパティ | キャラクターのポップアップメニューに表示される | [音声コマンド] ウィンドウに表示される |
|---|---|---|---|---|---|
| はい | はい | はい | 真 | はい(Caption を使用) | はい(VoiceCaption を使用) |
| はい | はい | No¹ | 真 | はい(Caption を使用) | いいえ |
| はい | はい | はい | 偽 | いいえ | はい(VoiceCaption を使用) |
| はい | はい | No¹ | 偽 | いいえ | いいえ |
| No¹ | はい | はい | 真 | いいえ | はい(VoiceCaption を使用) |
| No¹ | はい | はい | 偽 | いいえ | はい(VoiceCaption を使用) |
| No¹ | はい | No¹ | 真 | いいえ | いいえ |
| No¹ | はい | No¹ | 偽 | いいえ | いいえ |
| はい | No¹ | はい | 真 | はい(Caption を使用) | はい(Caption を使用) |
| はい | No¹ | No¹ | 真 | はい | いいえ |
| はい | No¹ | はい | 偽 | いいえ | はい(Caption を使用) |
| はい | No¹ | No¹ | 偽 | いいえ | いいえ |
| No¹ | No¹ | はい | 真 | いいえ | No² |
| No¹ | No¹ | はい | 偽 | いいえ | No² |
| No¹ | No¹ | No¹ | 真 | いいえ | いいえ |
| No¹ | No¹ | No¹ | 偽 | いいえ | いいえ |
¹ プロパティ設定が null の場合。 一部のプログラミング言語では、空の文字列が null 文字列と同じとは解釈されない場合があります。
²コマンドは引き続き音声でアクセスできます。
一般に、音声 設定を使用して コマンド を定義する場合は、関連付けられている Commands コレクションの キャプション と 音声 設定も定義します。 一連のコマンドの Commands コレクションに 音声 がないか、Caption 設定がなく、現在入力がアクティブな場合は、 ただし、コマンド キャプション と 音声 設定、クライアント アプリケーションが入力アクティブになると、コマンド ウィンドウのツリー ビューの [(未定義のコマンド)]に表示。
サーバーは、Commands コレクションに対して定義した Command オブジェクトのいずれかに一致する入力を受け取ると、IAgentNotifySink::Command イベントを送信し、IAgentUserInput オブジェクトの属性としてコマンドの ID を返します。 その後、条件付きステートメントを使用して、コマンドの照合と処理を行うことができます。
Vtable Order のメソッドを する
| 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 オブジェクトの ID を返します。 |