.\" $Xorg: XtExtEvDis.man,v 1.3 2000/08/17 19:42:00 cpqbld Exp $
.\"
.\" Copyright (c) 1993, 1994  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 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 
.\" dealing 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 Thu Oct 22 00:07:24 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Fri Oct 12 00:10:20 JST 2001 for XFree86b 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" WORD: extension selector	拡張セレクタ
.\"
.\" $XFree86: xc/doc/man/Xt/XtExtEvDis.man,v 1.3 2001/02/09 03:47:50 tsi 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 XtInsert-Event-Type-Handler XtRemove-Event-Type-Handler XtSet-Event-Dispatcher XtDispatch-Event-To-Widget 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 XtInsertEventTypeHandler 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
.\"0 XtInsertEventTypeHandler, XtRemoveEventTypeHandler,
.\"0 XtRegisterExtensionSelector, XtSetEventDispatcher, XtDispatchEventToWidget
.\"0 \- extension event handling
XtInsertEventTypeHandler, XtRemoveEventTypeHandler,
XtRegisterExtensionSelector, XtSetEventDispatcher, XtDispatchEventToWidget
\- 拡張イベント処理
.SH 書式
void XtInsertEventTypeHandler(\fIwidget\fP, \fIevent_type\fP,
\fIselect_data\fP, \fIproc\fP, \fIclient_data\fP, \fIposition\fP)
.br
      Widget \fIwdget\fP;
.br
      int \fIevent_type\fP;
.br
      XtPointer \fIselect_data\fP;
.br
      XtEventHandler \fIproc\fP;
.br
      XtPointer \fIclient_data\fP;
.br
      XtListPosition \fIposition\fP;
.LP
void XtRemoveEventTypeHandler(\fIwidget\fP, \fIevent_type\fP,
\fIselect_data\fP, \fIproc\fP, \fIclient_data\fP)
.br
      Widget \fIwdget\fP;
.br
      int \fIevent_type\fP;
.br
      XtPointer \fIselect_data\fP;
.br
      XtEventHandler \fIproc\fP;
.br
      XtPointer \fIclient_data\fP;
.LP
void XtRegisterExtensionSelector(\fIdisplay\fP, \fImin_event_type\fP,
\fImax_event_type\fP, \fIproc\fP, \fIclient_data\fP)
.br
      Display* \fIdisplay\fP;
.br
      int \fImin_event_type\fP;
.br
      int \fImax_event_type\fP;
.br
      XtExtensionSelectProc \fIproc\fP;
.br
      XtPointer \fIclient_data\fP;
.LP
XtEventDispatchProc XtSetEventDispatcher(\fIdisplay\fP, \fIevent_type\fP,
\fIproc\fP)
.br
      Widget \fIwidget\fP;
.br
      int \fIevent_type\fP;
.br
      XtEventDispatchProc \fIproc\fP;
.LP
Boolean XtDispatchEventToWidget(\fIwidget\fP, \fIevent\fP)
.br
      Widget \fIwidget\fP;
.br
      XEvent* \fIevent\fP;
.LP
.SH 引き数
.IP \fIwidget\fP 1i
.\"0 Specifies the widget for this event handler.
このイベントハンドラに対するウィジェットを指定する。
.\"0 Must be of class Core or any subclass thereof.
Core クラスかそのサブクラスでなければならない。
.IP \fIevent_type\fP 1i
.\"0 Specifies the event type.
イベント型を指定する。
.IP \fIselect_data\fP 1i
.\"0 Specifies data used to select or deselect events from the server.
サーバからのイベントを選択または選択解除するために使うデータを指定する。
.IP \fIproc\fP 1i
.\"0 Specifies the proc.
手続きを指定する。
.IP \fIclient_data\fP 1i
.\"0 Specifies additional data to be passed to the event handler.
イベントハンドラに渡す追加的なデータを指定する。
.IP \fIposition\fP 1i
.\"0 Specifies when the event handler is to be called relative to other
.\"0 previously registered handlers.
以前に登録された他のハンドラに対して、このイベントハンドラがいつ呼ばれ
るかを指定する。
.IP \fIdisplay\fP 1i
.\"0 Specifies the display.
ディスプレイを指定する。
.IP \fImin_event_type,\ max_event_type\fP 1i
.\"0 Specifies the range of event types for this extension.
この拡張に対するイベント型の範囲を指定する。
.IP \fIevent\fP 1i
.\"0 Specifies a pointer to the event to be dispatched.
配送するイベントへのポインタを指定する。
.SH 説明
.\"0 The
.\"0 .ZN XtInsertEventTypeHandler
.\"0 function registeres a procedure with the dispatch mechanism that is to
.\"0 be called when an event that matches the specified \fIevent_type\fP is
.\"0 dispatched to the specified \fIwidget\fP.
関数
.ZN XtInsertEventTypeHandler
は、手続きを配送機構に登録する。この手続きは、指定された 
\fIevent_type\fP にマッチするイベントが指定された \fIwidget\fP に対し
て配送されたときに呼び出される。
.LP
.\"0 If \fIevent_type\fP is one of the core X protocol events then 
.\"0 \fIselect_data\fP must be a pointer to a value of type
.\"0 .ZN EventMask ,
.\"0 indicating the event mask to be used to select for the desired event.
\fIevent_type\fP がコア X プロトコルイベントの1つならば、
\fIselect_data\fP は
.ZN EventMask
型の値へのポインタでなければならない。この値は求めるイベントを選択する
ために使うイベントマスクを示す。
.\"0 This event mask will be included in the value returned by
.\"0 .ZN XtBuildEventMask .
このイベントマスクは、
.ZN XtBuildEventMask
が返す値に含まれる。
.\"0 If the widget is realized
.\"0 .ZN XtInsertEventTypeHandler
.\"0 calls
.\"0 .ZN XSelectInput
.\"0 if necessary. Specifying NULL for \fIselect_data\fP is equivalent to
.\"0 specifying a pointer to an event mask containing 0. This is similar to the 
.\"0 .ZN XtInsertRawEventHandler
.\"0 function.
このウィジェットがリアライズされている場合は、
.ZN XtInsertEventTypeHandler
は必要に応じて
.ZN XSelectInput
を呼び出す。\fIselect_data\fP に NULL を指定することは、値が0であるイ
ベントマスクを指すポインタを指定することと等価である。この動作は、関数
.ZN XtInsertRawEventHandler
と同様である。
.LP
.\"0 If \fIevent_type\fP specifies an extension event type then the semantics
.\"0 of the data pointed to by \fIselect_data\fP are defined by the extension
.\"0 selector registered for the specified event type.
\fIevent_type\fP が拡張イベント型を指定している場合には、
\fIselect_data\fP が指すデータの意味は、指定したイベント型に対して
登録された拡張セレクタによって定義される。
.LP
.\"0 In either case the Intrinsics are not required to copy the data pointed
.\"0 to by \fIselect_data\fP, so the caller must ensure that it remains valid
.\"0 as long as the event handler remains registered with this value of
.\"0 \fIselect_data\fP.
どちらの場合でも、イントリンシクスは \fIselect_data\fP が指すデータを
コピーすることは求められない。したがって、イベントハンドラがこの
\fIselect_data\fP の値で登録されている限りは、呼び出し側はこのデータが
ずっと有効であることを保証しなければならない。
.LP
.\"0 The \fIposition\fP argument allows the client to control the order of the
.\"0 invocation of event handlers registered for the same event type. If the
.\"0 client does not care about the order, it should normally specify
.\"0 .ZN XtListTail ,
.\"0 which registers this event handler after any previously registered
.\"0 handlers for this event type.
引き数 \fIposition\fP を使って、クライアントは同じイベント型に登録さ
れたイベントハンドラが呼び出される順序制御することができる。呼び出す順
序を問題にしない場合は、通常
.ZN XtListTail
を指定すべきである。この指定により、このイベントハンドラはこのイベント
タイプに以前に登録されたどのハンドラよりも後に登録される。
.LP
.\"0 The
.\"0 .ZN XtRemoveEventTypeHandler
.\"0 function unregisters an even handler registered with
.\"0 .ZN XtInsertEventTypeHandler
.\"0 for the specified event type. The request is ignored if \fIclient_data\fP
.\"0 does not match the value given with the handler was registered.
関数
.ZN XtRemoveEventTypeHandler
は、
.ZN XtInsertEventTypeHandler
を使って指定したイベント型に登録されたイベントハンドラの登録を抹消
する。\fIclient_data\fP がハンドラが登録されたときに与えられた値と一致
しない場合には、このリクエストは無視される。
.LP
.\"0 If \fIevent_type\fP specifies on of the core X protocol events,
.\"0 \fIselect_data\fP must be a pointer to a value of type
.\"0 .ZN EventMask ,
.\"0 indicating the mask to be used to deselect for the appropriate event.
\fIevent_type\fP がコア X プロトコルイベントの1つならば、
\fIselect_data\fP は
.ZN EventMask
型の値へのポインタでなければならない。この値は適切なイベントの選択を解
除するために使うイベントマスクを示す。
.\"0 If the widget is realized,
.\"0 .ZN XtRemoveEventTypeHandler
.\"0 calls
.\"0 .ZN XSelectInput
.\"0 if necessary. Specifying NULL for \fIselect_data\fP is equivalent to
.\"0 specifying a pointer to an event mask containing 0. This is similar to the
.\"0 .ZN XtRemoveRawEventHandler
.\"0 function.
このウィジェットがリアライズされている場合は、
.ZN XtRemoveEventTypeHandler
は必要に応じて
.ZN XSelectInput
を呼び出す。\fIselect_data\fP に NULL を指定することは、値が0であるイ
ベントマスクを指すポインタを指定することと等価である。これは、関数
.ZN XtRemoveRawEventHandler
と似ている。
.LP
.\"0 If \fIevent_type\fP specifies an extension event type then the semantics
.\"0 of the data pointed to by \fIselect_data\fP are defined by the extension
.\"0 selector registered for the specified event type.
\fIevent_type\fP が拡張イベント型を指定している場合には、
\fIselect_data\fP が指すデータの意味は、指定したイベント型に対して
登録された拡張セレクタによって定義される。
.LP
.\"0 The
.\"0 .ZN XtRegisterExtensionSelector
.\"0 function registers a procedure to arrange for the delivery of extension
.\"0 events to widgets.
関数
.ZN XtRegisterExtensionSelector
は、拡張イベントのウィジェットへの通知について調整を行う手続きを登録す
る。
.LP
.\"0 If \fImin_event_type\fP and \fImax_event_type\fP match the parameters to
.\"0 a previous call to
.\"0 .ZN XtRegisterExtensionSelector
.\"0 for the same display, the \fIproc\fP and \fIclient_data\fP replace the
.\"0 previously registered values. If the range specified by \fImin_event_type\fP
.\"0 and \fImax_event_type\fP overlaps the range of the parameters to a
.\"0 previous call for the same display in any other way, an error results.
\fImin_event_type\fP と \fImax_event_type\fP が、同じディスプレイに対
する以前の
.ZN XtRegisterExtensionSelector
の呼び出しに渡したパラメータと一致する場合、\fIproc\fP と 
\fIclient_data\fP は前に登録した値を置き換える。
\fImin_event_type\fP と \fImax_event_type\fP で指定した範囲が、以前に
同じディスプレイに対して別の方法で呼び出したときのパラメータと重なる場
合にはエラーが起こる。
.LP
.\"0 The
.\"0 .ZN XtSetEventDispatcher
.\"0 function registes the event dispatcher procedure specified by \fIproc\fP
.\"0 for event swith the type \fIevent_type\fP. The previously registered
.\"0 dispatcher (or the default dispatcher if there was no previousl registered
.\"0 dispatcher) is returned. If \fIproc\fP is NULL, the default procedure is
.\"0 restored for the specified type.
関数.ZN XtSetEventDispatcher
は、指定された \fIevent_type\fP 型のイベントに対して、\fIproc\fP で指
定されたイベントディスパッチャ手続きを登録する。この関数は、前に登録し
たディスパッチャを返す(前に登録されてない場合には、デフォルトのディス
パッチャが返される)。\fIproc\fP が NULL ならば、指定したタイプに対して
デフォルトの手続きが格納される。
.LP
.\"0 In the future, when
.\"0 .ZN XtDispatchEvent
.\"0 is called with an event of \fIevent_type\fP, the specified \fIproc\fP (or
.\"0 the default dispatcher) will be invoked to determine a widget ot which
.\"0 to dispatch the event.
後で
.ZN XtDispatchEvent
が
イベント
\fIevent_type\fP
を使って呼び出されたとき、イベントを配送するウィジェットを決め
るために、指定された \fIproc\fP (またはデフォルトのディスパッチャ)が呼
び出される。
.LP
.\"0 The
.\"0 .ZN XtDispatchEventToWidget
.\"0 function scans the list of registered event handlers for the specified
.\"0 widget and calls each handler that has been registered for the specified
.\"0 event type, subject to the \fIcontinue_to_dispatch\fP value returned by
.\"0 each handler. The Intrinsics behave as if event handlers were registered
.\"0 at the head of the list for
.\"0 .ZN Expose ,
.\"0 .ZN NoExpose ,
.\"0 .ZN GraphicsExpose ,
.\"0 and
.\"0 .ZN VisibilityNotify
.\"0 events to invoke the widget's expose procedure according to the exposure
.\"0 compression rules and to update the widget's \fIvisible\fP field if
.\"0 \fIvisible_interest\fP is
.\"0 .ZN True .
関数
.ZN XtDispatchEventToWidget
は、指定されたウィジェットに対して登録されたイベントハンドラのリストを
走査し、それぞれのハンドラが返した \fIcontinue_to_dispatch\fP 値に従っ
て、指定したイベント型に対して登録されたイベントハンドラを呼び出す。
.ZN Expose ,
.ZN NoExpose ,
.ZN GraphicsExpose ,
.ZN VisibilityNotify
の各イベントについては、
イントリンシクスは、イベントハンドラがリストの先頭に登録されたかのよう
に振舞う。
これは露出の圧縮規則に従ってウィジェットの露出手続きを呼び、
\fIvisible_interest\fP が
.ZN True
ならばウィジェットの \fIvisible\fP フィールドを更新するために行われる。
.\"0 These internal event handlers never set \fIcontinue_to_dispatch\fP to
.\"0 .ZN False .
これらの内部イベントハンドラは、決して \fIcontinue_to_dispatch\fP に
.ZN False
を設定しない。
.LP
.\"0 .ZN XtDispatchEventToWidget
.\"0 returns
.\"0 .ZN True
.\"0 if any event handler was called and
.\"0 .ZN False
.\"0 otherwise.
.ZN XtDispatchEventToWidget
は、イベントハンドラのいずれかが呼び出された場合には
.ZN True
を返し、いずれも呼び出されなかった場合には
.ZN False
を返す。
.LP
.SH 関連項目
XtGetKeyboardFocusWidget(3Xt)
.br
\fI\*(xT\fP
.br
\fI\*(xL\fP