書式

XtSetKeyboardFocus(subtree, descendant)

     Widget subtree, descendant;

引き数

descendant

キーボードイベントを受け取るサブツリー構造内の子孫ウィジェット、または None を指定する。 以前に入力フォーカスが設定されていないときに None を指定しても誤りではない点に注意すること。

w

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

説明

将来に KeyPress イベントか KeyRelease イベントが指定したサブツリー内で起こった場合、 XtSetKeyboardFocus は XtDispatchEvent を引き起こし、そのイベントを指定した子孫ウィジェットに再マップして送る。

モーダルカスケードが無い場合は、ウィジェット W 内でのキーボードイベント の起き方は以下の 3 つのうちのいずれかである:

• W が X の入力フォーカスを持つ。
• W が祖先ウィジェットのうちの1つのキーボードフォーカスを持ち、イベント が祖先かその子孫のどれかの上で起こる。
• W のいずれの祖先もキーボードフォーカス内にある子孫ウィジェットを持たず、 ポインタが W 内にある。

モーダルカスケードがある場合は、ウィジェット W の祖先ウィジェットがア クティブなモーダルカスケードのサブセットに含まれ、前の条件の1つ以上が True ならば、W はキーボードイベントを受け取る。

サブツリーか子孫ウィジェットの 1 つが X の入力フォーカスを獲得するか、 キーボードイベントが伝えられるようなサブツリー内にポインタが入ったとき、 その子孫ウィジェットが FocusNotify イベントを選択しているならば、このウィジェットに対して FocusIn イベントが生成される。 同様に、W が X の入力フォーカスまたは祖先ウィジェットの 1 つに対する キーボードフォーカスを失ったとき、この子孫ウィジェットが FocusNotify イベントを選択しているならば、このウィジェットに対して FocusOut イベントが生成される。