.\" $Xorg: XtOwnSel.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:17:38 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Fri Oct 12 00:40:20 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/Xt/XtOwnSel.man,v 1.3 2001/02/09 03:47:51 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 XtOwn-Selection XtOwn-Selection-Incremental XtDisown-Selection 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 XtOwnSelection 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
.\"0 XtOwnSelection, XtOwnSelectionIncremental, XtDisownSelection \- set selection owner
XtOwnSelection, XtOwnSelectionIncremental, XtDisownSelection \- セレクションの所有者を設定する
.SH 書式
Boolean XtOwnSelection(\fIw\fP, \fIselection\fP, \fItime\fP,
\fIconvert_proc\fP, \fIlose_selection\fP, \fIdone_proc\fP)
.br
      Widget \fIw\fP;
.br
      Atom \fIselection\fP;
.br
      Time \fItime\fP;
.br
      XtConvertSelectionProc \fIconvert_proc\fP;
.br
      XtLoseSelectionProc \fIlose_selection\fP;
.br
      XtSelectionDoneProc \fIdone_proc\fP;
.LP
Boolean XtOwnSelectionIncremental(\fIw\fP, \fIselection\fP, \fItime\fP,
\fIconvert_callback\fP, \fIlose_callback\fP, \fIdone_callback\fP,
\fIcancel_callback\fP, \fIclient_data\fP)
.br
      Widget \fIw\fP;
.br
      Atom \fIselection\fP;
.br
      Time \fItime\fP;
.br
      XtConvertSelectionIncrProc \fIconvert_callback\fP;
.br
      XtLoseSelectionIncrProc \fIlose_callback\fP;
.br
      XtSelectionDoneIncrProc \fIdone_callback\fP;
.br
      XtCancelConvertSelectionProc \fIcancel_callback\fP;
.br
      XtPointer \fIclient_data\fP;
.LP
void XtDisownSelection(\fIw\fP, \fIselection\fP, \fItime\fP)
.br
      Widget \fIw\fP;
.br
      Atom \fIselection\fP;
.br
      Time \fItime\fP;
.SH 引き数
.IP \fIconvert_proc\fP 1i
.\"0 Specifies the procedure that is to be called whenever someone requests the 
.\"0 current value of the selection.
セレクションの現在値が要求されたときに呼び出される手続きを指定する。
.IP \fIdone_proc\fP 1i
.\"0 Specifies the procedure that is called 
.\"0 after the requestor has received the selection or NULL if the owner is not
.\"0 interested in being called back.
リクエスタがセレクションを受け取った後に呼び出される手続きを指定する。
所有者がコールバックを必要としない場合には、NULL を指定する。
.IP \fIlose_selection\fP 1i
.\"0 Specifies the procedure that is to be called whenever the widget has 
.\"0 lost selection ownership or NULL if the owner is not interested in being 
.\"0 called back.
ウィジェットがセレクションの所有を失ったときに呼び出される手続きを指定する。
所有者がコールバックを必要としない場合には、NULL を指定する。
.IP \fIselection\fP 1i
.\"0 Specifies an atom that describes the type of the selection (for example,
.\"0 .ZN XA_PRIMARY , 
.\"0 .ZN XA_SECONDARY , 
.\"0 or
.\"0 .ZN XA_CLIPBOARD ).
セレクションのタイプを指定するアトムを指定する(例えば、
.ZN XA_PRIMARY , 
.ZN XA_SECONDARY , 
.ZN XA_CLIPBOARD
等)。
.ds Ti ownership should commence or is to be relinquished
.IP \fItime\fP 1i
.\"0 Specifies the timestamp that indicates when the selection \*(Ti.
セレクションの所有を開始する時間、または所有を放棄する時間の
タイムスタンプを指定する。
.ds Wi that wishes to become the owner or to relinquish ownership
.IP \fIw\fP 1i
.\"0 Specifies the widget \*(Wi.
所有者となるウィジェットまたは所有を放棄するウィジェットを指定する。
.SH 説明
.\"0 The
.\"0 .ZN XtOwnSelection
.\"0 function informs the \*(xI selection mechanism that a
.\"0 widget believes it owns a selection.
関数
.ZN XtOwnSelection
は、ウィジェットがセレクションを所有しようとしていることをイントリンシ
クスのセレクション機構に知らせる。
.\"0 It returns 
.\"0 .ZN True 
.\"0 if the widget has successfully become the owner and 
.\"0 .ZN False
.\"0 otherwise.
この関数は、ウィジェットがうまく所有者になれた場合には
.ZN True 
を返し、なれなかった場合には
.ZN False
を返す。
.\"0 The widget may fail to become the owner if some other widget 
.\"0 has asserted ownership at a time later than this widget.
このウィジェットよりも少し後に他のウィジェットがセレクションの所有権を
要求した場合、最初のウィジェットは所有者になれないことがある。
.\"0 Note that widgets can lose selection ownership either 
.\"0 because someone else asserted later ownership of the selection 
.\"0 or because the widget voluntarily gave up ownership of the selection.
ウィジェットが所有権を失う場合が2つあることに注意せよ。一つは、他のウィ
ジェットが後からウィジェットの所有権を求めた場合で、もう一つはウィジェッ
トが自発的にセレクションの所有権を放棄した場合である。
.\"0 Also note that the lose_selection procedure is not called 
.\"0 if the widget fails to obtain selection ownership in the first place.
最初にウィジェットがセレクションの所有権の取得に失敗した場合、
lose_selection 手続きは呼び出されない点に注意。
.LP
.\"0 The
.\"0 .ZN XtOwnSelectionInrcremental
.\"0 procedure informs the Intrinsics incremental selection mechanism that
.\"0 the specified widget wishes to own the selection. It returns
.\"0 .ZN True 
.\"0 if the specified widget successfully becomes the selection owner or
.\"0 .ZN False
.\"0 otherwise. For more information about \fIselection\fP, \fItarget\fP,
.\"0 and \fItime\fP, see Section 2.6 of the \fIInter-Client Communication
.\"0 Conventions Manual\fP.
.ZN XtOwnSelectionInrcremental
手続きは、指定したウィジェットがセレクションの所有を求めていることをイ
ントリンシクスのインクリメンタルセレクション機構に知らせる。
この関数は、ウィジェットがうまく所有者になれた場合には
.ZN True 
を返し、なれなかった場合には
.ZN False
を返す。\fIselection\fP, \fItarget\fP, \fItime\fP に関する詳しい情報に
ついては、\fIInter-Client Communication Conventions Manual\fP の 2.6 
章を参照すること。
.LP
.\"0 A widget that becomes the selection owner using
.\"0 .ZN XtOwnSelectionIncremental
.\"0 may use
.\"0 .ZN XtDisownSelection
.\"0 to relinquish selection ownership.
.ZN XtOwnSelectionIncremental
を使ってセレクションの所有者となったウィジェットは、
.ZN XtDisownSelection
を使ってセレクションの所有権を放棄することができる。
.LP
.\"0 The
.\"0 .ZN XtDisownSelection
.\"0 function informs the \*(xI selection mechanism that
.\"0 the specified widget is to lose ownership of the selection.
.\"0 If the widget does not currently own the selection either 
.\"0 because it lost the selection 
.\"0 or because it never had the selection to begin with,
.\"0 .ZN XtDisownSelection
.\"0 does nothing.
関数
.ZN XtDisownSelection
は、指定したウィジェットがセレクションの所有権を失うことを、イントリン
シクスのセレクション機構に知らせる。既にセレクションを失っているか、最
初からセレクションを所有していないためにそのウィジェットが現在セレクショ
ンを所有していない場合には、
.ZN XtDisownSelection
は何もしない。
.LP
.\"0 After a widget has called
.\"0 .ZN XtDisownSelection ,
.\"0 its convert procedure is not called even if a request arrives later 
.\"0 with a timestamp during the period that this widget owned the selection.
ウィジェットが
.ZN XtDisownSelection
を呼んだ後は、このウィジェットがセレクションを所有していた間のタイムス
タンプを持つリクエストが後で到着した場合であっても、この変換手続きは呼
ばれない。
.\"0 However, its done procedure will be called if a conversion that started 
.\"0 before the call to
.\"0 .ZN XtDisownSelection
.\"0 finishes after the call to
.\"0 .ZN XtDisownSelection .
しかし、
.ZN XtDisownSelection
を呼ぶ前に始まった変換が
.ZN XtDisownSelection
を呼んだ後に終わった場合は、ウィジェットの done 手続きが呼ばれる。
.SH 関連項目
XtAppGetSelectionTimeout(3Xt),
XtGetSelectionValue(3Xt)
.br
\fI\*(xT\fP
.br
\fI\*(xL\fP