名称

XtSetKeyboardFocus − 子ウィジェット上のイベントをフォーカスする

形式

XtSetKeyboardFocus(subtree, descendant)
     Widget subtree, descendant;

引数

descendantキーボードイベントを受取るサブツリー構造中のウィジェット、または None のいずれかを指定します。 なお、入力フォーカスが前に何も設定されていない場合に、 None を指定してもエラーではないことに注意してください。

subtreeキーボードフォーカスを設定する ウィジェットを指定します。

解説

XtSetKeyboardFocus 関数は、 KeyPress または KeyRelease イベントが、指定された subtree 内で発生したとき、 XtDispatchEvent に、そのイベントをリマップし、それを指定された descendant ウィジェットへ送らせます。 モーダルカスケードが何もないときは、 キーボードイベントは、次の 3 通りの方法のうちのひとつで、 ウィジェット W 内に発生します。

•W が X ウィンドウ全体の入力をフォーカスしている。

•W がその先祖のうちのひとつのキーボード入力をフォーカスし、 イベントが、その先祖または先祖の子孫のうちのひとつ内で発生する。

•W の先祖がキーボードフォーカスしている子孫をもたず、 ポインタが W 内にある。 モーダルカスケードがある場合、 ウィジェット W は、 W の先祖が、 モーダルカスケードの動的サブセット中にあり、前の状態がひとつ以上 True の場合は、キーボードイベントを受取ります。 subtree またはその子孫のうちのひとつが X の入力フォーカスを獲得したとき、 または ( マウス ) ポインタが subtree 内へ移動したとき、 すなわちキーボードイベントが subtree に渡されるようになったとき、 FocusIn イベントが descendant に生成されます。 ただし、 descendant が、 FocusNotify イベントをセレクトしていることが必要です。 同様に、 W が X の入力フォーカスを失うか、 先祖に対するキーボードフォーカスを失ったとき、 descendant に対して FocusOut イベントが生成されます。 ただし descendant が FocusNotify イベントをセレクトしている場合のみです。

関連事項

XtCallAcceptFocus(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 4.1C