クリック イベント

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

説明

ユーザーがキャラクターまたはキャラクターのアイコンをクリックしたときに発生します。

構文

Sub agent**_Click** (ByVal CharacterID, ByVal Button, ByVal Shift, ByVal X, ByVal Y**)**

部分	説明
CharacterID	クリックしたキャラクターの ID を文字列として返します。
Button	イベントを発生させるために押されて離されたボタンを識別する整数を返します。 button 引数は、左ボタン (ビット 0)、右ボタン (ビット 1)、中央ボタン (ビット 2) に対応するビットを含むビットフィールドです。 これらのビットはそれぞれ値 1、2、4 に対応しています。 イベントの原因となったボタンを示す、いずれか 1 つのビットのみが設定されます。 キャラクターにタスク バー アイコンが含まれており、ビット 13 も設定されている場合は、タスク バー アイコンのクリックが発生しました。
Shift	button 引数で指定されたボタンが押されるか離されたときに、Shift キー、Ctrl キー、Alt キーの状態に対応する整数を返します。 キーが押されている場合はビットが設定されます。 shift 引数は、Shift キー (ビット 0)、Ctrl キー (ビット 1)、Alt キー (ビット 2) に対応する最下位ビットが含まれるビットフィールドです。 これらのビットはそれぞれ値 1、2、4 に対応しています。 shift 引数はこれらのキーの状態を示します。 一部またはすべてのビットを設定することも、ビットを一切設定しないこともでき、キーの一部またはすべてが押されたか、まったく押されていないことを示します。 たとえば、Ctrl キーと Alt キーの両方が押された場合、shift の値は 6 になります。
X,Y	マウス ポインターの現在の位置を示す整数を返します。 X と Y の値は、画面の左上隅を基準にして常にピクセル単位で表されます。

 

解説

このイベントは、キャラクターの入力アクティブなクライアントにのみ送信されます。 ユーザーが入力アクティブなクライアントを持たないキャラクターまたはそのタスク バー アイコンをクリックすると、サーバーはアクティブなクライアントにイベントを送信します。 キャラクターが表示されている場合 (Visible = True)、ユーザーのアクションは、キャラクターの最後の入力アクティブなクライアントを現在の入力アクティブなクライアントとして設定し、ActivateInput イベントをそのクライアントに送信してから Click イベントを送信します。 キャラクターが非表示 (Visible = False) で、ユーザーがボタン 1 を使用してキャラクターのタスク バー アイコンをクリックすると、キャラクターも自動的に表示されます。

Note

キャラクターをクリックしても、他のすべてのキャラクター出力 (すべてのキャラクター) は無効になりません。 ただし、Listening キーを押すと、入力アクティブなキャラクターの出力がフラッシュされ、RequestComplete イベントがトリガーされ、クライアントのキューが中断されたことを示す Request.Status が渡されます。