.\" $Xorg: XtSetSP.man,v 1.3 2000/08/17 19:42:03 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 02:09:19 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Oct 14 15:59:06 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/Xt/XtSetSP.man,v 1.3 2001/02/09 03:47:52 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 XtSet-Selection-Parameters XtGet-Selection-Parameters 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 XtSetSelectionParameters 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
.\"0 XtSetSelectionParameters \- specify target parameters for a selection request with a single target
XtSetSelectionParameters \- 単独対象のセレクションリクエストに対して、対象パラメータを指定する
.SH 書式
void XtSetSelectionParameters(\fIrequestor\fP, \fIselection\fP, \fItype\fP,
\fIvalue\fP, \fIlength\fP, \fIformat\fP)
.br
      Widget \fIrequestor\fP;
.br
      Atom \fIselection\fP;
.br
      Atom \fItype\fP;
.br
      XtPointer \fIvalue\fP;
.br
      unsigned long \fIlength\fP;
.br
      int \fIformat\fP;
.LP
.SH 引き数
.IP \fIrequestor\fP 1i
.\"0 Specifies the widget making the request. Must be of clase Core or any
.\"0 subclass thereof.
リクエストを生成したウィジェットを指定する。
Core クラスかそのサブクラスでなければならない。
.IP \fIselection\fP 1i
.\"0 Specifies the atom that names the selection.
セレクションを示すアトムを指定する。
.IP \fItype\fP 1i
.\"0 Specifies the type of the property in which the parameters will be passed.
パラメータを渡すプロパティの型を指定する。
.IP \fIvalue\fP 1i
.\"0 Specifies a pointer to the parameters.
パラメータへのポインタを指定する。
.IP \fIlength\fP 1i
.\"0 Specifies the number of elements containing data in \fIvalue\fP, each
.\"0 element of a sized indicated by \fIformat\fP.
\fIvalue\fP に含まれるデータの要素数を指定する。各要素のサイズは 
\fIformat\fP で示される。
.IP \fIformat\fP 1i
.\"0 Specifies the size in bits of the data in the elements of \fIvalue\fP.
\fIvalue\fP の要素に含まれるデータのサイズをビット単位で指定する。
.SH 説明
.\"0 The specified parameters will be copied and stored in a new property of
.\"0 the specified type and format on the requestor's window. To initiate a
.\"0 selection request with a target and these parameters, a subsequent call to
.\"0 .ZN XtGetSelectionValue
.\"0 or to
.\"0 .ZN XtGetSelectionValueIncremental
.\"0 specifying the same requestor widget and selection atomm will generate a
.\"0 .ZN ConvertSelection
.\"0 request referring referring to the property containing the parameters. If
.\"0 .ZN XtSetSelectionParameters
.\"0 is called more than once with the same widget and selection without a
.\"0 call to specify a request, the most recently specified parameters are
.\"0 used in the subsequent request.
リクエスタのウィンドウ上で、指定されたパラメータは指定されたタイプとフォー
マットである新しいアトムにコピー・格納される。これに続いて、対象とこれ
らのパラメータを使うセレクションリクエストを行うため、同じリクエスタウィ
ジェットとセレクションアトムを使った
.ZN XtGetSelectionValue
または
.ZN XtGetSelectionValueIncremental
の呼び出しによって、パラメータを持つプロパティを参照する
.ZN ConvertSelection
リクエストが生成される。
リクエストを指定した呼び出しを行なうことなく、同じウィジェットとセレク
ションを使って
.ZN XtSetSelectionParameters
を複数回呼んだ場合、最も新しいパラメータ指定が以降のリクエストで使われ
る。
.LP
.\"0 The possible values of \fIformat\fP may be 8, 16, or 32. If the \fIformat\fP
.\"0 is 8, the elements of \fIvalue\fP are assumed to be sizeof(char); if 16,
.\"0 sizeof(short); if 32, sizeof(long).
\fIformat\fP が取ることができる値は8, 16, 32 である。 \fIformat\fP が 
8 ならば、\fIvalue\fP の要素の大きさは sizeof(char) と仮定される。同様
に値が 16 ならば sizeof(short), 32 ならば sizeof(long) と仮定される。
.LP
.\"0 To generate a MULTIPLE target request with parameters for any of the
.\"0 multiple targets of the selection request, precede individual calls to
.\"0 .ZN XtGetSelectionValue
.\"0 and
.\"0 .ZN XtGetSelectionValueIncremental
.\"0 with corresponding individual calls to
.\"0 .ZN XtSetSelectionParameters ,
.\"0 and enclose these all within
.\"0 .ZN XtCreateSelectionRequest
.\"0 and
.\"0 .ZN XtSendSelectionRequest .
セレクションリクエストの複数の対象に対して、パラメータを使った複数対象
リクエストを生成するためには、対応する
.ZN XtSetSelectionParameters
の個別の呼び出しよりも前に
.ZN XtGetSelectionValue
と
.ZN XtGetSelectionValueIncremental
の個別の呼び出しを行い、これら全体を
.ZN XtCreateSelectionRequest
と
.ZN XtSendSelectionRequest
で囲むこと。
.\"0 .ZN XtGetSelectionValues 
.\"0 and
.\"0 .ZN XtGetSelectionValuesIncremental
.\"0 cannot be used  to make selection requests with parameterized targets.
.ZN XtGetSelectionValues 
と
.ZN XtGetSelectionValuesIncremental
は、パラメータ付きの対象を使ってセレクションリクエストを作るために使う
ことはできない。
.SH 関連項目
XtGetSelectionParameters(3Xt)
.br
\fI\*(xT\fP
.br
\fI\*(xL\fP