XtRegisterDrawable(3) イントリンシクスのイベントディスパッチャにドロウアブルを登録する

書式

void XtRegisterDrawable(display, drawable, widget)

      Display* display;

      Drawable drawable;

      Widget widget;

void XtUnregisterDrawable(display, drawable)

      Display* display;

      Drawable drawable;

引き数

display
ドロウアブルのディスプレイを指定する。
drawable
登録するドロウアブルを指定する。
widget
ドロウアブルを登録する先のウィジェットを指定する。

説明

XtRegisterDrawable は指定したドロウアブルを指定したウィジェットに対応づける。これにより、後で このドロウアブルを使って XtWindowToWidget を呼び出したときには同じウィジェットが返される。デフォルトのイベントディ スパッチャは、将来にそのドロウアブルと共にウィジェットに通知されたコア イベントを配送するとき、イベントがそのウィジェットのウィンドウ を含むかのように処理を行う。 しかし、イベントハンドラやアクション手続きに渡されるときでも、 イベントそのものは全く変化しない。

そのドロウアブルが既に他のウィジェットに登録されている場合や、ドロウア ブルがそのクライアントのウィジェットツリー内のウィジェットのウィンドウ である場合には、 XtRegisterDrawable の呼び出しの結果は未定義である。

XtUnregisterDrawable は、 XtRegisterDrawable で作られた対応関係を削除する。 ドロウア ブルがそのクライアントのウィジェットツリー内のウィジェットのウィンドウ である場合には、 XtUnregisterDrawable の呼び出しの結果は未定義である。