.\" $Xorg: XtGetSValI.man,v 1.3 2000/08/17 19:42:01 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 Tue Oct 27 00:00:00 JST 1998 .\" by FUJIWARA Teruyoshi .\" Updated Thu Oct 11 01:45:33 JST 2001 for XFree86 4.1.0 .\" by FUJIWARA Teruyoshi .\" .\" WORD: selection セレクション .\" WORD: selection value セレクション値 .\" .\" $XFree86: xc/doc/man/Xt/XtGetSValI.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 XtGet-Selection-Value-Incremental XtGet-Selection-Values-Incremental 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 XtGetSelectionValueIncremental 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS" .SH 名前 .\"0 XtGetSelectionValueIncremental, XtGetSelectionValuesIncremental \- obtain selection values XtGetSelectionValueIncremental, XtGetSelectionValuesIncremental \- セレクションの値を取得する .SH 書式 void XtGetSelectionValueIncremental(\fIw\fP, \fIselection\fP, \fItarget\fP, \fIcallback\fP, \fIclient_data\fP, \fItime\fP) .br Widget \fIw\fP; .br Atom \fIselection\fP; .br Atom \fItarget\fP; .br XtSelectionCallbackProc \fIcallback\fP; .br XtPointer \fIclient_data\fP; .br Time \fItime\fP; .LP void XtGetSelectionValuesIncremental(\fIw\fP, \fIselection\fP, \fItargets\fP, \fIcount\fP, \fIcallback\fP, \fIclient_data\fP, \fItime\fP) .br Widget \fIw\fP; .br Atom \fIselection\fP; .br Atom *\fItargets\fP; .br int \fIcount\fP; .br XtSelectionCallbackProc \fIcallback\fP; .br XtPointer \fIclient_data\fP; .br Time \fItime\fP; .SH 引き数 .ds Cb \ that is to be called when the selection value has been obtained .IP \fIcallback\fP 1i .\"0 Specifies the callback procedure\*(Cb. セレクション値が既に取得されていたときに呼び出されるコールバック手続き を指定する。 .ds Cd it is called .IP \fIclient_data\fP 1i .\"0 Specifies the argument that is to be passed to the specified procedure .\"0 when \*(Cd. 指定された手続きが呼び出されたとき、この手続きに渡される引き数を指定する。 .IP \fIclient_data\fP 1i .\"0 Specifies the client data (one for each target type) .\"0 that is passed to the callback procedure when it is called for that target. コールバックの手続きが目的のタイプに対して呼ばれたときに、この手続きに 渡されるクライアントデータを指定する(それぞれの対象の型に対して1つずつ)。 .IP \fIcount\fP 1i .\"0 Specifies the length of the targets and client_data lists. 引き数 targets と client_data のリストの長さを指定。 .IP \fIselection\fP 1i .\"0 Specifies the particular selection desired (that is, primary or secondary). 必要な特定のセレクションを指定する(つまり、プライマリまたはセカンダリであ る)。 .IP \fItarget\fP 1i .\"0 Specifies the type of the information that is needed about the selection. セレクションについて必要な情報の型を1つを指定する。 .IP \fItargets\fP 1i .\"0 Specifies the types of information that is needed about the selection. セレクションについて必要な情報の型を複数個指定する。 .ds Ti value is desired .IP \fItime\fP 1i .\"0 Specifies the timestamp that indicates when the selection \*(Ti. セレクションの値が必要な時を示すタイムスタンプを指定する。 .ds Wi that is making the request .IP \fIw\fP 1i .\"0 Specifies the widget \*(Wi. リクエストを発行するウィジェットを指定する。 .SH 説明 .\"0 The .\"0 .ZN XtGetSelectionValueIncremental .\"0 function is similar to .\"0 .ZN XtGetSelectionValue .\"0 except that the \fIselection_callback\fP procedure will be called .\"0 repeatedly upon delivery of multiple segments of the selection value. 関数 .ZN XtGetSelectionValueIncremental は .ZN XtGetSelectionValue とほぼ同じである。ただし、複数に分割されたセレクション値の一部が届くた びに \fIselection_callback\fP 手続きが繰り返し呼ばれる点だけが異なる。 .\"0 The end of the selection value is indicated when \fIselection_callback\fP .\"0 is called with a non-NULL value of length zero, which must still be .\"0 freed by the client. If the transfer of the selection is aborted in the .\"0 middle of a transfer (for example, because to timeout), the .\"0 \fIselection_callback\fP procedure is called with a type value equal .\"0 to the symbolic constant .\"0 .ZN XT_CONVERT_FAIL .\"0 so that the requestor can dispose of the partial selection value it has .\"0 collected up until that point. Upon receiving .\"0 .ZN XT_CONVERT_FAIL , .\"0 the requesting client must determine for itself whether or not a .\"0 partially completed transfer is meaningful. セレクション値の終わりは、長さが 0 の NULL でない値を使って \fIselection_callback\fP が呼ばれたときである。長さが 0 であっても、 クライアントはこの値を解放しなければならない。(例えばタイムアウト等に より)転送が途中で失敗した場合、シンボル定数 .ZN XT_CONVERT_FAIL に等しいタイプ値を使って \fIselection_callback\fP 手続きが呼び出される。 これによりリクエスタは、その時点まで集められていたセレクションの断片を 処分することができる。 .ZN XT_CONVERT_FAIL を受け取った場合は、リクエストを出したクライアントは部分的にしか終わっ ていない転送に意味があるかどうかを決めなくてはならない。 .LP .\"0 The .\"0 .ZN XtGetSelectionValuesIncremental .\"0 function is similar to .\"0 .ZN XtGetSelectionValueIncremental .\"0 except that it takes a list of target types and a list of client data .\"0 and obtains the current value of the selection converted to each of the targets. 関数 .ZN XtGetSelectionValuesIncremental は、 .ZN XtGetSelectionValueIncremental とほぼ同じである。ただし、この関数は目的とするタイプのリストと、クライ アントデータのリストを引き数に取り、それぞれの目的タイプに変換されたセレ クション値を取得する。 .\"0 The effect is as if each target were specified in a separate call to .\"0 .ZN XtGetSelectionValueIncremental . この関数の実行結果は、別々の .ZN XtGetSelectionValueIncremental の呼び出しにおいて目的タイプをそれぞれ指定した場合と同様になる。 .\"0 The callback is called once with the corresponding client data for each target. それぞれの目的タイプについて、コールバックは対応するクライアントデータ を使って1度呼び出される。 .\"0 .ZN XtGetSelectionValuesIncremental .\"0 does guarantee that all the conversions will use the same selection value .\"0 becaues the ownership of the selection cannot change in the middle of the list, .\"0 as would be when calling .\"0 .ZN XtGetSelectionValueIncremental .\"0 repeatedly. .ZN XtGetSelectionValuesIncremental は、全ての変換において同じセレクション値が使われることを保証する。 なぜならば、 .ZN XtGetSelectionValueIncremental を繰り返し呼んだときのように、セレクションの所有者がリストの途中で変わ ることはあり得ないからである。 .SH 関連項目 .br \fI\*(xT\fP .br \fI\*(xL\fP