.\" $Xorg: XtSetKFoc.man,v 1.3 2000/08/17 19:42:02 cpqbld Exp $
.\"
.\" Copyright 1993 X Consortium
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining
.\" a copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish,
.\" distribute, sublicense, and/or sell copies of the Software, and to
.\" permit persons to whom the Software is furnished to do so, subject to
.\" the following conditions:
.\"
.\" The above copyright notice and this permission notice shall be
.\" included in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
.\" EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of the X Consortium shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from the X Consortium.
.\"
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\"
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\"
.\" Translated Tue Oct 20 23:59:48 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Oct 14 15:56:51 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" WORD: modal cascade	モーダルカスケード
.\"
.\" $XFree86: xc/doc/man/Xt/XtSetKFoc.man,v 1.2 2001/01/27 18:20:29 dawes Exp $
.\"
.ds tk X Toolkit
.ds xT X Toolkit Intrinsics \- C Language Interface
.ds xI Intrinsics
.ds xW X Toolkit Athena Widgets \- C Language Interface
.ds xL Xlib \- C Language X Interface
.ds xC Inter-Client Communication Conventions Manual
.ds Rn 3
.ds Vn 2.2
.hw XtSet-Keyboard-Focus wid-get
.na
.de Ds
.nf
.\\$1D \\$2 \\$1
.ft 1
.ps \\n(PS
.\".if \\n(VS>=40 .vs \\n(VSu
.\".if \\n(VS<=39 .vs \\n(VSp
..
.de De
.ce 0
.if \\n(BD .DF
.nr BD 0
.in \\n(OIu
.if \\n(TM .ls 2
.sp \\n(DDu
.fi
..
.de FD
.LP
.KS
.TA .5i 3i
.ta .5i 3i
.nf
..
.de FN
.fi
.KE
.LP
..
.de IN		\" send an index entry to the stderr
..
.de C{
.KS
.nf
.D
.\"
.\"	choose appropriate monospace font
.\"	the imagen conditional, 480,
.\"	may be changed to L if LB is too
.\"	heavy for your eyes...
.\"
.ie "\\*(.T"480" .ft L
.el .ie "\\*(.T"300" .ft L
.el .ie "\\*(.T"202" .ft PO
.el .ie "\\*(.T"aps" .ft CW
.el .ft R
.ps \\n(PS
.ie \\n(VS>40 .vs \\n(VSu
.el .vs \\n(VSp
..
.de C}
.DE
.R
..
.de Pn
.ie t \\$1\fB\^\\$2\^\fR\\$3
.el \\$1\fI\^\\$2\^\fP\\$3
..
.de ZN
.ie t \fB\^\\$1\^\fR\\$2
.el \fI\^\\$1\^\fP\\$2
..
.de NT
.ne 7
.ds NO Note
.if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2
.if \\n(.$ .if !'\\$1'C' .ds NO \\$1
.ie n .sp
.el .sp 10p
.TB
.ce
\\*(NO
.ie n .sp
.el .sp 5p
.if '\\$1'C' .ce 99
.if '\\$2'C' .ce 99
.in +5n
.ll -5n
.R
..
.		\" Note End -- doug kraft 3/85
.de NE
.ce 0
.in -5n
.ll +5n
.ie n .sp
.el .sp 10p
..
.ny0
.TH XtSetKeyboardFocus 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
.\"0 XtSetKeyboardFocus \- focus events on a child widget
XtSetKeyboardFocus \- イベントをある子ウィジェットにフォーカスさせる
.SH 書式
.\"0 XtSetKeyboardFocus(\fIsubtree\fP\, \fIdescendant\fP)
.\"0 fujiwara: 原文の typo
XtSetKeyboardFocus(\fIsubtree\fP, \fIdescendant\fP)
.br
     Widget \fIsubtree\fP, \fIdescendant\fP;
.SH 引き数
.IP \fIdescendant\fP 1i
.\"0 Specifies either the widget in the subtree structure which is to receive the 
.\"0 keyboard event, or 
.\"0 .ZN None .
キーボードイベントを受け取るサブツリー構造内の子孫ウィジェット、または
.ZN None
を指定する。
.\"0 Note that it is not an error to specify
.\"0 .ZN None
.\"0 when no input focus was previously set.
以前に入力フォーカスが設定されていないときに
.ZN None
を指定しても誤りではない点に注意すること。
.ds Wi for which the keyboard focus is to be set
.IP \fIw\fP 1i
.\"0 Specifies the widget \*(Wi.
キーボードフォーカスを設定するウィジェットを指定する。
.SH 説明
.\"0 If a future 
.\"0 .ZN KeyPress
.\"0 or
.\"0 .ZN KeyRelease 
.\"0 event occurs within the specified subtree,
.\"0 .ZN XtSetKeyboardFocus
.\"0 causes
.\"0 .ZN XtDispatchEvent
.\"0 to remap and send the event to the specified descendant widget.
将来に
.ZN KeyPress
イベントか
.ZN KeyRelease 
イベントが指定したサブツリー内で起こった場合、
.ZN XtSetKeyboardFocus
は
.ZN XtDispatchEvent
を引き起こし、そのイベントを指定した子孫ウィジェットに再マップして送る。
.LP
.\"0 When there is no modal cascade,
.\"0 keyboard events can occur within a widget W in one of three ways:
モーダルカスケードが無い場合は、ウィジェット W 内でのキーボードイベント
の起き方は以下の 3 つのうちのいずれかである:
.IP \(bu 5
.\"0 W has the X input focus.
W が X の入力フォーカスを持つ。
.IP \(bu 5
.\"0 W has the keyboard focus of one of its ancestors,
.\"0 and the event occurs within the ancestor or one of the ancestor's descendants.
W が祖先ウィジェットのうちの1つのキーボードフォーカスを持ち、イベント
が祖先かその子孫のどれかの上で起こる。
.IP \(bu 5
.\"0 No ancestor of W has a descendant within the keyboard focus,
.\"0 and the pointer is within W.
W のいずれの祖先もキーボードフォーカス内にある子孫ウィジェットを持たず、
ポインタが W 内にある。
.LP
.\"0 When there is a modal cascade,
.\"0 a widget W receives keyboard events if an ancestor of W is in the active
.\"0 subset of the modal cascade and one or more of the previous conditions is
.\"0 .ZN True .
モーダルカスケードがある場合は、ウィジェット W の祖先ウィジェットがア
クティブなモーダルカスケードのサブセットに含まれ、前の条件の1つ以上が
.ZN True
ならば、W はキーボードイベントを受け取る。
.LP
.\"0 When subtree or one of its descendants acquires the X input focus
.\"0 or the pointer moves into the subtree such that keyboard events would
.\"0 now be delivered to subtree, a
.\"0 .ZN FocusIn
.\"0 event is generated for the descendant if
.\"0 .ZN FocusNotify
.\"0 events have been selected by the descendant.
サブツリーか子孫ウィジェットの 1 つが X の入力フォーカスを獲得するか、
キーボードイベントが伝えられるようなサブツリー内にポインタが入ったとき、
その子孫ウィジェットが
.ZN FocusNotify
イベントを選択しているならば、このウィジェットに対して
.ZN FocusIn
イベントが生成される。
.\"0 Similarly, when W loses the X input focus
.\"0 or the keyboard focus for one of its ancestors, a
.\"0 .ZN FocusOut
.\"0 event is generated for descendant if
.\"0 .ZN FocusNotify
.\"0 events have been selected by the descendant.
同様に、W が X の入力フォーカスまたは祖先ウィジェットの 1 つに対する
キーボードフォーカスを失ったとき、この子孫ウィジェットが
.ZN FocusNotify
イベントを選択しているならば、このウィジェットに対して
.ZN FocusOut
イベントが生成される。
.SH 関連項目
XtCallAcceptFocus(3Xt)
.br
\fI\*(xT\fP
.br
\fI\*(xL\fP