次の方法で共有

Command オブジェクト

  • [アーティクル]

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

Command オブジェクトは、Commands コレクション内の項目です。 サーバーは、クライアント アプリケーションが入力アクティブになったときに 、Command オブジェクトへのユーザー アクセスを提供します。

Command オブジェクトの プロパティにアクセスするには、Name プロパティを使用してコレクション内で参照します。 VBScript と Visual Basic では、 Name プロパティを直接使用できます。

   <i>agent</i>.Characters("<i>CharacterID</i>").Commands("<i>Name</i>").<i>property</i> [= <i>value</i>]

コレクションをサポートしないプログラミング言語の場合は、 Command メソッドを使用します。

   <i>agent</i>.Characters("<i>CharacterID</i>").Commands.Command("<i>Name</i>").<i>property</i> [= <i>value</i>]

Command オブジェクトを参照するには、そのオブジェクトへの参照を作成します。 Visual Basic でオブジェクト変数を宣言し、Set ステートメントを使用して参照を作成します。

   Dim Cmd1 as Object
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

Visual Basic 5.0 では、オブジェクトを IAgentCtlCommandEx 型として宣言し、参照を作成することもできます。 この規則により、早期バインディングが有効になり、パフォーマンスが向上します。

   Dim Cmd1 as IAgentCtlCommandEx
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

VBScript では、参照を特定の型として宣言できますが、変数を宣言してコレクション内の Command に設定することもできます。

   Dim Cmd1
   ...
   Set Cmd1 = Agent.Characters("MyCharacterID").Commands("SampleCommand")
   ...
   Cmd1.Enabled = True

コマンドは、文字のポップアップ メニューとコマンド ウィンドウ、またはその両方に表示される場合があります。 ポップアップ メニューに表示するには、キャプションがあり、Visible プロパティが True に設定されている必要があります。 さらに、その Commands コレクション オブジェクト Visible プロパティも True に設定する必要があります。 コマンド ウィンドウに表示するには、 Command に Caption プロパティと Voice プロパティが設定されている必要があります。 メニューが表示されている間、文字のポップアップ メニュー エントリは変更されないことに注意してください。 文字のポップアップ メニューが表示されているときにコマンドを追加または削除したり、プロパティを変更したりすると、ユーザーが次に表示するたびにメニューにそれらの変更が表示されます。 ただし、[コマンド] ウィンドウには、行った変更が動的に反映されます。

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

Caption プロパティ

Voice-Caption プロパティ

Voice プロパティ

Visible プロパティ

Enabled プロパティ

キャラクターのポップアップメニューに表示される

コマンド ウィンドウに表示される

はい

はい

はい

True

True

標準(キャプションを使用)

はい(VoiceCaption を使用)

はい

はい

はい

True

False

キャプションを使用して無効

いいえ

はい

はい

はい

False

True

表示されない

はい(VoiceCaption を使用)

はい

はい

はい

False

False

表示されない

いいえ

はい

はい

いいえ

True

True

標準(キャプションを使用)

いいえ

はい

はい

いいえ

True

False

キャプションを使用して無効

いいえ

はい

はい

いいえ

False

True

表示されない

いいえ

はい

はい

いいえ

False

False

表示されない

いいえ

いいえ

はい

はい

True

True

表示されない

はい(VoiceCaption を使用)

いいえ

はい

はい

True

False

表示されない

いいえ

いいえ

はい

はい

False

True

表示されない

はい(VoiceCaption を使用)

いいえ

はい

はい

False

False

表示されない

いいえ

いいえ

はい

いいえ

True

True

表示されない

いいえ

いいえ

はい

いいえ

True

False

表示されない

いいえ

いいえ

はい

いいえ

False

True

表示されない

いいえ

いいえ

はい

いいえ

False

False

表示されない

いいえ

はい

いいえ

はい

True

True

標準(キャプションを使用)

はい(キャプションを使用 )

はい

いいえ

はい

True

False

キャプションを使用して無効

いいえ

はい

いいえ

はい

False

True

表示されない

はい(キャプションを使用 )

はい

いいえ

はい

False

False

表示されない

いいえ

はい

いいえ

いいえ

True

True

標準(キャプションを使用)

いいえ

はい

いいえ

いいえ

True

False

キャプションを使用して無効

いいえ

はい

いいえ

いいえ

False

True

表示されない

いいえ

はい

いいえ

いいえ

False

False

表示されない

いいえ

いいえ

いいえ

はい

True

True

表示されない

いいえ

いいえ

いいえ

はい

True

False

表示されない

いいえ

いいえ

いいえ

はい

False

True

表示されない

いいえ

いいえ

いいえ

はい

False

False

表示されない

いいえ

いいえ

いいえ

いいえ

True

True

表示されない

いいえ

いいえ

いいえ

いいえ

True

False

表示されない

いいえ

いいえ

いいえ

いいえ

False

True

表示されない

いいえ

いいえ

いいえ

いいえ

False

False

表示されない

いいえ

プロパティの設定が null の場合。 一部のプログラミング言語では、空の文字列が null 文字列と同じように解釈されない場合があります。 コマンドは引き続き音声でアクセスできます。

サーバーは、いずれかのコマンドの入力を受け取ると、Command イベントを送信し、UserInput オブジェクトの属性として Command の名前を返します。 その後、条件付きステートメントを使用して 、Command を照合して処理できます。