名称

XtAddEventHandler, XtAddRawEventHandler, XtRemoveEventHandler XtRemoveRawEventHandler − イベントハンドラを追加および削除する

形式

void XtAddEventHandler(w, event_mask, nonmaskable, proc, client_data)
      Widget w;
      EventMask event_mask;
      Boolean nonmaskable;
      XtEventHandler proc;
      caddr_t client_data; void XtAddRawEventHandler(w, event_mask, nonmaskable, proc, client_data)
      Widget w;
      EventMask event_mask;
      Boolean nonmaskable;
      XtEventHandler proc;
      caddr_t client_data; void XtRemoveEventHandler(w, event_mask, nonmaskable, proc, client_data)
      Widget w;
      EventMask event_mask;
      Boolean nonmaskable;
      XtEventHandler proc;
      caddr_t client_data; void XtRemoveRawEventHandler(w, event_mask, nonmaskable, proc, client_data)
      Widget w;
      EventMask event_mask;
      Boolean nonmaskable;
      XtEventHandler proc;
      caddr_t client_data;

引数

client_dataクライアントのイベントハンドラへ渡される付加データを指定します。

event_maskプロシージャをコールするか 、登録解除のためのイベントマスクを指定します。

nonmaskableプロシージャが nonmaskable イベント (GraphicsExpose、 NoExpose、 SelectionClear、 SelectionRequest、 SelectionNotify、 ClientMessage、 および MappingNotify) で コールされるのか、削除されるのか を指定します。

proc追加または削除する プロシージャを指定します。

wイベントハンドラが登録されている ウィジェットを指定します。

解説

XtAddEventHandler 関数は、指定されたウィジェット上でマスクしたイベントが発生したときに コールされるプロシージャをディスパッチメカニズムに登録します。 プロシージャがすでに同一の cliant_data に登録されている場合は、 指定されたマスクは、存在するマスクに論理和がとられます。 ウィジェットがリアライズされた場合、必要に応じて XtAddEventHandler は XSelectInput をコールします。 XtAddRawEventHandler 関数は、 ウィジェットのマスクに影響を及ぼさないことと、 そのイベントに対して決して XSelectInput を発生しないことを除けば、 XtAddEventHandler と同じです。 なお、ウィジェットには他の nonraw イベントハンドラが登録されていますので、 そのウィジェットはすでに、 それらのマスクビットのセットをもっていることに注意してください。 XtRemoveRawEventHandler 関数は、指定されたプロシージャが指定したイベントを受信することを 中止します。 なぜならば、そのプロシージャは、 raw イベントのハンドラなので、 ウィジェットのマスクに影響を及ぼすことはなく、決して XSelectInput をコールすることはしないからです。

関連事項

XtAppNextEvent(3Xt), XtBuildEventMask(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 3.3