XtSetSensitive(3) ウィジェットの sensitivity 状態の設定・チェックを行う

Other Alias

XtIsSensitive

書式

void XtSetSensitive(w, sensitive)

      Widget w;

      Boolean sensitive;

Boolean XtIsSensitive(w)

     Widget w;

引き数

sensitive
ウィジェットがキーボードイベントとポインタイベントを受け取るかどうか指 示する Boolean 値を指定する。
w
ウィジェットを指定する。

説明

関数 XtSetSensitive は、最初に現在のウィジェットに対して、sensitive フィールドを新しい値に 変更するかどうか指示する引き数リストを使って XtSetValues を呼ぶ。 その後、この関数は新しい値をマネージされている子ウィジェットのツリーで 再帰的に伝播させる。 これは、sensitive 値に対する新しい値とそれぞれの子ウィジェットの ancestor_sensitive 値が異なる場合に XtSetValues を呼び出して、この子ウィジェットの ancestor_sensitive を新しい値にセッ トすることによって行われる。

XtSetSensitive は、 sensitive 値と ancestor_sensitive 値を変更するために XtSetValues を呼び出す。 したがって、これらの変更を行ったときには、ウィジェットの set_values 手 続きは必要とされる表示アクション(例えば、ウィジェエットのグレイアウト 処理やスティプル処理)をすべて行わなければならない。

XtSetSensitive は、親の sensitive 値か ancestor_sensitive 値が False ならば 全ての子の ancestor_sensitive は False であるという条件を常に守り続ける。

XtIsSensitive は、ユーザ入力イベントが配送されるかどうかを示す値を返す。 これは True または False である。 XtIsSensitive は、 core.sensitive と core.ancestor_sensitive の両方が True ならば True を返し、そうでない場合には False を返す。