ポップアップ メニューのサポート

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

Microsoft エージェントには、各文字のポップアップ メニュー (コンテキスト メニューとも呼ばれます) が含まれています。 ユーザーが文字を右クリックすると、サーバーによってこのポップアップ メニューが自動的に表示されます。 Commands コレクションを定義することで、クライアント アプリケーションのコマンドをメニューに追加できます。 定義するコレクション内の各コマンドに対して、Captionプロパティ指定したり、Visibleプロパティしたりできます。 キャプション は、Visible プロパティが True に設定されている場合にメニューに表示されるテキストです。 Enabled プロパティを使用して、メニューにコマンドを無効として表示したり、HelpContextID を使用してプロパティのヘルプ サポートをサポートしたりすることもできます。 Caption テキスト設定のテキスト文字の前にアンパサンド (&) を含めることで、メニュー テキストのアクセス キーを定義します。

サーバーは、音声コマンド ウィンドウを開いて文字を非表示にするためのメニュー コマンドに自動的に追加します。また、コマンド 文字の他のクライアントのキャプションを使用して、ユーザーがクライアントを切り替えることができます。 サーバーは、メニューエントリとクライアントによって定義されたメニューの間に自動的に区切り記号を追加します。 区切り記号は、分離する項目がメニューに存在する場合にのみ表示されます。

メニューからコマンドを削除するには、Remove メソッドを使用します。 メニューが表示されている間、メニュー エントリは変更されないことに注意してください。 コマンドを追加または削除したり、そのプロパティを変更したりすると、ユーザーがメニューを再表示したときにメニューに変更が表示されます。

文字に独自のポップアップ メニュー サービスを提供する場合は、AutoPopupMenu プロパティを使用して、右クリック アクションのサーバー処理を無効にすることができます。 その後、Click イベント通知を使用して、独自のメニュー処理動作を作成できます。

ユーザーがキャラクターのポップアップ メニューまたは音声コマンド ウィンドウからコマンドを選択すると、サーバーは関連付けられたクライアントの Command イベントをトリガーし、UserInput オブジェクトを使用して入力のパラメーターを返します。

サーバーには、キャラクターのタスク バー アイコンのポップアップ メニューも用意されています。 文字が表示されている場合、このメニューを右クリックすると、文字を右クリックして表示されるものと同じコマンドが表示されます。 ただし、文字が非表示の場合は、サーバー指定のコマンドのみが含まれます。