other versions
- wheezy 4.1.0.20011224-6
XSendExtensionEvent(3X11) | X FUNCTIONS | XSendExtensionEvent(3X11) |
名前¶
XSendExtensionEvent - 拡張入力イベントをクライアントに送る書式¶
Status XSendExtensionEvent( display, device, destination, propagate, event_count, event_list, event_send)Display * display;
XDevice * device;
Window destination;
Bool propagate;
int event_count;
XEventClass * event_list;
XEvent * event_send;
引き数¶
- display
- X サーバへの接続を指定する。
- device
- イベントが送られてくるデバイスを指定する。
- destination
- イベントが送られるウィンドウを指定する。 ウィンドウID, PointerWindow, InputFocus のいずれかを指定する。
- propagate
- True か Flase の真偽値を指定する。
- event_count
- event_list 内の XEventClass の数を指定する。
- event_list
- 使用するイベントセレクションのリストを指定する。
- event_send
- 送られるイベントへのポインタを指定する。
説明¶
XSendExtensionEvent リクエストは、対象のウィンドウを識別し、指定したイベントをどのクライア ントが受け取るのかを決定し、全てのアクティブなグラブを無視する。 このリクエストにはイベントクラスのリストを渡す必要がある。 正しいイベントクラス名については、 XOpenDevice(3X11) を参照するこ と。 このリクエストは引き数 w を使い、以下に示すように対象ウィンドウを識別す る。- •
- w が PointerWindow ならば、 対象ウィンドウはポインタを含むウィンドウである。
- •
- w が InputFocus であり、フォーカスウィンドウがポインタを含む場合、対象ウィンドウはポイ ンタを含むウィンドウである。 そうでない場合は、対象ウィンドウはフォーカスウィンドウである。
- •
- evnet_list が空リストの場合、イベントは対象ウィンドウを作ったクライア ントに送られる。 このクライアントが既に存在しなくなった場合には、イベントはどこにも送ら れない。
- •
- propagete が False ならば、イベントは event_list 配列で指定されるイベント型のいずれか を対象ウィンドウ上で選択している全てのクライアントに送られる。
- •
- propagete が True であり、event_list 配列で指定されるイベントのいずれかを対象ウィンドウ 上で選択しているクライアントがない場合には、対象ウィンドウは 次の条件を満たすウィンドウに置き換えられる。その条件とは、対象ウィンド ウにできるだけ近い祖先ウィンドウであり、対象ウィンドウとのそのウィンド ウの間のウィンドウがこのイベント型の伝播を止めるようなマスクを持っ ていないことである。 そのようなウィンドウが存在しない場合や、そのウィンドウがフォーカスウィ ンドウの祖先ウィンドウであり、元々 InputFocus が対象ウィンドウとして指定されている場合、このイベントはいかなるクライ アントにも送られない。 そうでない場合、イベントは最終的な対象ウィンドウ上で event_list 配列で 指定されているイベントのいずれかを選択しているウィンドウ全てに通知され る。
返り値¶
- BadDevice
- 不正なデバイスが指定された。指定したデバイスが存在しないか、クライアン トの XOpenInputDevice によってオープンされていない。このエラーは 指定されたデバイスが X のキーボードデバイスか X のポインタデバイスであ る場合にも起こる。
- BadValue
- 数値の中にリクエストの許容範囲を越えるものがある。引き数に対して特定の範 囲が指定されない限り、引き数の型の全ての範囲が許される。選択肢として定義 された引き数は、このエラーを起こすことがある。
- BadWindow
- 引き数 Window の値が、定義されている Window を指していない。
関連項目¶
Programming with XlibRelease 6.5 | X Version 11 |