.\" $Xorg: XtSetVal.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 Fri Oct 23 19:56:59 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Oct 14 16:05:35 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/doc/man/Xt/XtSetVal.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-Values XtVa-Set-Values XtSet-Subvalues XtVa-Set-Subvalues XtGet-Values XtVa-Get-Values XtGet-Subvalues XtVa-Get-Subvalues constraint-Widget-Class 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 XtSetValues 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
.\"0 XtSetValues, XtVaSetValues, XtSetSubvalues, XtVaSetSubvalues, XtGetValues, XtVaGetValues, XtGetSubvalues, XtVaGetSubvalues \- obtain and set widget resources 
XtSetValues, XtVaSetValues, XtSetSubvalues, XtVaSetSubvalues, XtGetValues, XtVaGetValues, XtGetSubvalues, XtVaGetSubvalues \- ウィジェットのリソースを取得・設定する
.SH 書式
void XtSetValues(\fIw\fP, \fIargs\fP, \fInum_args\fP)
.br
      Widget \fIw\fP;
.br
      ArgList \fIargs\fP;
.br
      Cardinal \fInum_args\fP;
.LP
void XtVaSetValues(\fIw\fP, \fI...\fP)
.br
      Widget \fIw\fP;
.LP
void XtSetSubvalues(\fIbase\fP, \fIresources\fP, \fInum_resources\fP,
\fIargs\fP, \fInum_args\fP)
.br
      XtPointer \fIbase\fP;
.br
      XtResourceList \fIresources\fP;
.br
      Cardinal \fInum_resources\fP;
.br
      ArgList \fIargs\fP;
.br
      Cardinal \fInum_args\fP;
.LP
void XtVaSetSubvalues(\fIbase\fP, \fIresources\fP, \fInum_resources\fP, \fI...\fP)
.br
      XtPointer \fIbase\fP;
.br
      XtResourceList \fIresources\fP;
.br
      Cardinal \fInum_resources\fP;
.LP
void XtGetValues(\fIw\fP, \fIargs\fP, \fInum_args\fP)
.br
      Widget \fIw\fP;
.br
      ArgList \fIargs\fP;
.br
      Cardinal \fInum_args\fP;
.LP
void XtVaGetValues(\fIw\fP, \fI...\fP)
.br
      Widget \fIw\fP;
.LP
void XtGetSubvalues(\fIbase\fP, \fIresources\fP, \fInum_resources\fP,
\fIargs\fP, \fInum_args\fP)
.br
      XtPointer \fIbase\fP;
.br
      XtResourceList \fIresources\fP;
.br
      Cardinal \fInum_resources\fP;
.br
      ArgList \fIargs\fP;
.br
      Cardinal \fInum_args\fP;
.LP
void XtVaGetSubvalues(\fIbase\fP, \fIresources\fP, \fInum_resources\fP, \fI...\fP)
.br
      XtPointer \fIbase\fP;
.br
      XtResourceList \fIresources\fP;
.br
      Cardinal \fInum_resources\fP;
.SH 引き数
.\"0 .ds Al of name/address pairs that contain the resource name
.\"0 and either the address into which the resource value is to be stored
.\"0 or their new values
.IP \fIargs\fP 1i
.\"0 Specifies the argument list \*(Al.
名前/アドレスの組である引き数リストを指定する。名前はリソース名であり、
アドレスはリソース値が格納されるアドレスまたはその新しい値である。
.ds Ba retrieved or written
.IP \fIbase\fP 1i
.\"0 Specifies the base address of the subpart data structure where the resources
.\"0 should be \*(Ba.
サブパートデータ構造体のベースアドレスを指定する。
この構造体はリソースの取得、書き込みが行われるものである。
.IP \fInum_args\fP 1i
.\"0 Specifies the number of arguments in the argument list.
引き数リスト内の引き数の数を指定する。
.IP \fIresources\fP 1i
.\"0 Specifies the nonwidget resource list or values.
ウィジェットでないリソースのリストまたは値を指定する。
.IP \fInum_resources\fP 1i
.\"0 Specifies the number of resources in the resource list.
リソースのリスト内のリソースの数を指定する。
.IP \fIw\fP 1i
.\"0 Specifies the widget.
ウィジェットを指定する。
.IP \fI...\fP 1i
.\"0 Specifes the variable argument list \*(Al.
名前/アドレスの組である可変長引き数リストを指定する。名前はリソース名であり、
アドレスはリソース値が格納されるアドレスまたはその新しい値である。
.SH 説明
.\"0 The
.\"0 .ZN XtSetValues
.\"0 function starts with the resources specified for the 
.\"0 .ZN Core 
.\"0 widget fields and proceeds down the subclass chain to the widget.
関数
.ZN XtSetValues
は、
.ZN Core 
ウィジェットのフィールドに対して指定されたリソースから処理を始め、その
ウィジェットまでサブクラスの関係をたどってゆく。
.\"0 At each stage,
.\"0 it writes the new value (if specified by one of the arguments) or the existing
.\"0 value (if no new value is specified) to a new widget data record.
各クラスにおいて、新しいウィジェットのデータレコードには新しい値(引き数
で指定されている場合)または既存の値(新しい値が指定されていない場合)が
書き込まれる。
.\"0 .ZN XtSetValues
.\"0 then calls the set_values procedures for the widget in superclass-to-subclass 
.\"0 order.
次に
.ZN XtSetValues
は、スーパークラス-サブクラスの順でウィジェットの set_values 手続きを
呼び出す。
.IN "hook"
.\"0 If the widget has any non-NULL set_values_hook fields,
.\"0 these are called immediately after the
.\"0 corresponding set_values procedure.
このウィジェットが NULL でない set_value_hook フィールドを持っている場
合には、対応する set_values 手続きの直後にこのフックが呼び出される。
.\"0 This procedure permits subclasses to set nonwidget data for
.\"0 .ZN XtSetValues .
この手続きを使って、サブクラスは
.ZN XtSetValues
に対してウィジェットでないデータをセットすることができる。
.LP
.\"0 If the widget's parent is a subclass of
.\"0 .ZN constraintWidgetClass ,
.\"0 .ZN XtSetValues
.\"0 also updates the widget's constraints.
ウィジェットの親が
.ZN constraintWidgetClass
のサブクラスである場合、このウィジェットの constraint 情報も更新される。
.\"0 It starts with the constraint resources specified for
.\"0 .ZN constraintWidgetClass
.\"0 and proceeds down the subclass chain to the parent's class.
この関数は
.ZN constraintWidgetClass
に対して指定された constraint リソースから処理を始め、その親のクラスま
でサブクラスの関係をたどってゆく。
.\"0 At each stage,
.\"0 it writes the new value or the existing value to a new constraint record.
各クラスのにおいて、新しい constraint レコードには新しい値と既存の値が
書き込まれる。
.\"0 It then calls the constraint set_values procedures from
.\"0 .ZN constraintWidgetClass
.\"0 down to the parent's class.
次に、この関数は
.ZN constraintWidgetClass
から親ウィジェットのクラスという順序で、constraint 情報についての
set_values 手続きを呼び出す。
.\"0 The constraint set_values procedures are called with widget arguments,
.\"0 as for all set_values procedures, not just the constraint record arguments,
.\"0 so that they can make adjustments to the desired values based
.\"0 on full information about the widget.
constraint 情報に関する set_value 手続きがウィジェットの引き数を使って呼
び出される。この引き数は、constraint レコードの引き数だけでなく、レコード
全ての set_values 手続きについてのものである。これにより、ウィジェット
に関する全ての情報に基づいて、望ましい値への調整を行うことができる。
.LP
.\"0 .ZN XtSetValues
.\"0 determines if a geometry request is needed by comparing the current widget to
.\"0 the new widget.
.ZN XtSetValues
は、現在のウィジェットと新しいウィジェットを比較し、geometry リクエス
トが必要かどうか決める。
.\"0 If any geometry changes are required,
.\"0 it makes the request, and the geometry manager returns
.\"0 .ZN XtGeometryYes ,
.\"0 .ZN XtGeometryAlmost ,
.\"0 or
.\"0 .ZN XtGeometryNo .
ジオメトリの変更が必要ならば、この関数はリクエストを発行する。これに対
して、ジオメトリマネージャは
.ZN XtGeometryYes ,
.ZN XtGeometryAlmost ,
.ZN XtGeometryNo
のいずれかを返す。
.\"0 If
.\"0 .ZN XtGeometryYes ,
.\"0 .ZN XtSetValues
.\"0 calls the widget's resize procedure.
.ZN XtGeometryYes
の場合は、
.ZN XtSetValues
はウィジェットの resize 手続きを呼び出す。
.\"0 If
.\"0 .ZN XtGeometryNo ,
.\"0 .ZN XtSetValues
.\"0 resets the geometry fields to their original values.
.ZN XtGeometryNo
の場合は、
.ZN XtSetValues
は geometory フィールドを元の値にリセットする。
.\"0 If
.\"0 .ZN XtGeometryAlmost ,
.\"0 .ZN XtSetValues
.\"0 calls the set_values_almost procedure,
.\"0 which determines what should be done and writes new values for the
.\"0 geometry fields into the new widget.
.ZN XtGeometryAlmost
の場合は、
.ZN XtSetValues
は set_values_almost 手続きを呼び出す。
この手続きは行うべき処理を決定し、geometry フィールドに対する新しい値
を新しいウィジェットに書き込む。
.\"0 .ZN XtSetValues
.\"0 then repeats this process,
.\"0 deciding once more whether the geometry manager should be called.
それから
.ZN XtSetValues
は、ジオメトリマネージャを再び呼び出すべきか判定しながらこの処
理を繰り返す。
.LP
.\"0 Finally, if any of the set_values procedures returned 
.\"0 .ZN True ,
.\"0 .ZN XtSetValues
.\"0 causes the widget's expose procedure to be invoked by calling the Xlib
.\"0 .ZN XClearArea
.\"0 function on the widget's window.
最後に、set_values 手続きのうちに1つでも
.ZN True
を返すものがあった場合、
.ZN XtSetValues
はウィジェットのウィンドウに対して Xlib の
.ZN XClearArea
関数を呼び出し、ウィジェットの露出手続きを起こさせる。
.LP
.\"0 The
.\"0 .ZN XtSetSubvalues
.\"0 function stores resources into the structure identified by base.
関数
.ZN XtSetSubvalues
は、引き数 base で識別される構造体にリソースを格納する。
.LP
.\"0 The
.\"0 .ZN XtGetValues
.\"0 function starts with the resources specified for the core widget fields
.\"0 and proceeds down the subclass chain to the widget.
関数
.ZN XtGetValues
は、コアウィジェットのフィールドに対して指定されたリソースから処理を始
め、そのウィジェットまでサブクラスの関係をたどってゆく。
.\"0 The value field of a passed argument list should contain the
.\"0 address into which to store the corresponding resource value.
渡された引き数リストの value フィールドは、対応するリソース値を格納する
領域のアドレスでなければならない。
.\"0 It is the caller's responsibility
.\"0 to allocate and deallocate this storage according to the size of the
.\"0 resource representation type used within the widget.
関数の呼び出し側はウィジェット内で使われているリソース表現型に基づき、
この領域の割り当てと解放を行わなければならない。
.LP
.\"0 If the widget's parent is a subclass of
.\"0 .ZN constraintWidgetClass ,
.\"0 .ZN XtGetValues
.\"0 then fetches the values for any constraint resources requested.
このウィジェットの親が
.ZN constraintWidgetClass
のサブクラスである場合、これに続いて
.ZN XtGetValues
は要求された constraint リソースに対する値を取得する。
.\"0 It starts with the constraint resources specified for
.\"0 .ZN constraintWidgetClass
.\"0 and proceeds down to the subclass chain to the parent's constraint resources.
この関数は、
.ZN constraintWidgetClass
に対して指定された constraint リソースから処理を始め、このウィジェット
の親の constraint リソースまでサブクラスの関係をたどってゆく。
.\"0 If the argument list contains a resource name that is not found in any of the
.\"0 resource lists searched, 
.\"0 the value at the corresponding address is not modified.
検索されたリソースリスト内に無いリソース名が引き数リストに含まれている場
合、これに対応するアドレスに格納されている値が変更されることはない。
.IN "hook"
.\"0 Finally, if the get_values_hook procedures are non-NULL, 
.\"0 they are called in superclass-to-subclass order after
.\"0 all the resource values have been fetched by
.\"0 .ZN XtGetValues .
最後に、get_values_hook 手続きが NULL でない場合、
.ZN XtGetValues
を使って全てのリソース値を取得した後にスーパークラス-サブクラスの順で
これらの手続きが呼び出される。
.\"0 This permits a subclass to provide nonwidget resource data to
.\"0 .ZN XtGetValues .
これを使って、サブクラスはウィジェットでないリソースデータを
.ZN XtGetValues
に対して提供することができる。
.LP
.\"0 The
.\"0 .ZN XtGetSubvalues
.\"0 function obtains resource values from the structure identified by base.
関数
.ZN XtGetSubvalues
は、引き数 base で識別される構造体からリソース値を取得する。
.SH 関連項目
.br
\fI\*(xT\fP
.br
\fI\*(xL\fP