.\" $Xorg: XtManChild.man,v 1.3 2000/08/17 19:42:01 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 Mon Oct 19 20:33:14 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Fri Oct 12 00:15:14 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" WORD: manage マネージ(する)
.\" WORD: unmanage マネージ解除(する)
.\" WORD: manage set マネージセット
.\"
.\" $XFree86: xc/doc/man/Xt/XtManChild.man,v 1.2 2001/01/27 18:20:28 dawes 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 XtManage-Children XtManage-Child XtUnmanage-Children XtUnmanage-Child XtChange-ManagedSet XtIs-Managed 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 XtManageChildren 3Xt "Release 6.5" "X Version 11" "XT FUNCTIONS"
.SH 名前
.\"0 XtManageChildren, XtManageChild, XtUnmanageChildren, XtUnmanageChild, XtChangeManagedSet, XtIsManaged \- manage and unmanage children
XtManageChildren, XtManageChild, XtUnmanageChildren, XtUnmanageChild, XtChangeManagedSet, XtIsManaged \- 子ウィジェットのマネージとマネージ解除を行う
.SH 書式
typedef Widget *WidgetList;
.sp
void XtManageChildren(\fIchildren\fP, \fInum_children\fP)
.br
      WidgetList \fIchildren\fP;
.br
      Cardinal \fInum_children\fP;
.LP
void XtManageChild(\fIchild\fP)
.br
      Widget \fIchild\fP;
.LP
void XtUnmanageChildren(\fIchildren\fP, \fInum_children\fP)
.br
      WidgetList \fIchildren\fP;
.br
      Cardinal \fInum_children\fP;
.LP
void XtUnmanageChild(\fIchild\fP)
.br
      Widget \fIchild\fP;
.LP
void XtChangeManagedSet(\fIunmanage_children\fP, \fInum_unmanage_children\fP, \fImanage_children\fP, \fInum_manage_children\fP, \fIpost_unmanage_pre_manage_hook\fP, \fIclient_data\fP)
.br
      WidgetList \fIunmanage_children\fP;
.br
      Cardinal \fInum_unmanage_children\fP;
.br
      WidgetList \fImanage_children\fP;
.br
      Cardinal \fInum_manage_children\fP;
.br
      XtCSMProc \fIpost_unmanage_pre_manage_hook\fP;
.br
      XtPointer \fIclient_data\fP;
.LP
Boolean XtIsManaged(\fIwidget\fP)
.br
      Widget \fIwidget\fP
.SH 引き数
.IP \fIchild\fP 1i
.\"0 Specifies the child.
子ウィジェットを指定する。
.IP \fIchildren\fP 1i
.\"0 Specifies a list of child widgets.
子ウィジェットのリストを指定する。
.IP \fInum_children\fP 1i
.\"0 Specifies the number of children.
子ウィジェットの数を指定する。
.IP \fIwidget\fP 1i
.\"0 Specifies the widget.
ウィジェットを指定する。
.IP \fImanage_children\fP 1i
.\"0 Specifies the list of widget children to add to the managed set.
マネージセットに追加する子ウィジェットのリストを指定する。
.IP \fInum_manage_children\fP 1i
.\"0 Specifies the number of entries in the manage_children list.
manage_children リスト内のエントリー数を指定する。
.IP \fIunmanage_children\fP 1i
.\"0 Specifies the list of widget children to remove from the managed set.
マネージセットから取り除く子ウィジェットのリストを指定する。
.IP \fInum_unmanage_children\fP 1i
.\"0 Specifies the number of entries in the unmanage_children list.
unmanage_children リスト内のエントリー数を指定する。
.IP \fIpost_unmanage_pre_manage_hook\fP 1i
.\"0 Specifies the post unmanage, pre manage hook procedure to invoke.
マネージ解除後、マネージ前に呼び出すフック手続きを指定する。
.IP \fIclient_data\fP 1i
.\"0 Specifies the client data to be passed to the hook precedure.
フック手続きに渡すクライアントデータを指定する。
.SH 説明
.\"0 The
.\"0 .ZN XtManageChildren
.\"0 function performs the following:
関数
.ZN XtManageChildren
は以下の処理を行う:
.IP \(bu 5
.\"0 Issues an error if the children do not all have the same parent or
.\"0 if the parent is not a subclass of 
.\"0 .ZN compositeWidgetClass .
親の異なる子ウィジェットが含まれる場合や親ウィジェットが
.ZN compositeWidgetClass
のサブクラスでない場合に、エラーを出す。
.IP \(bu 5
.\"0 Returns immediately if the common parent is being destroyed;
.\"0 otherwise, for each unique child on the list,
.\"0 .ZN XtManageChildren
.\"0 ignores the child if it already is managed or is being destroyed
.\"0 and marks it if not.
共通の親が破棄されようとしている場合は、即座に戻ってくる。そうでなけれ
ば、リスト中のユニークな子ウィジェットのそれぞれに対して、
.ZN XtManageChildren
は、その子ウィジェットが既にマネージされているか、破棄されようとしてい
る場合にはこれをを無視する。また、マークが付いていなければ、これにマー
クを付ける。
.IP \(bu 5
.\"0 If the parent is realized and after all children have been marked,
.\"0 it makes some of the newly managed children viewable:
親ウィジェットがリアライズされていて、かつ全ての子ウィジェットにマーク
が付けられている場合、新しくマネージされた子ウィジェットの一部は表示可
能になる。
.RS
.IP \- 5
.\"0 Calls the change_managed routine of the widgets' parent.
そのウィジェットの親ウィジェットの change_managed 手続きを呼ぶ。
.IP \- 5
.\"0 Calls
.\"0 .ZN XtRealizeWidget
.\"0 on each previously unmanaged child that is unrealized.
前にマネージ解除された子ウィジェットのうち、リアライズ解除されているも
のそれぞれについて
.ZN XtRealizeWidget
を呼ぶ。
.IP \- 5
.\"0 Maps each previously unmanaged child that has map_when_managed 
.\"0 .ZN True .
前にマネージ解除された子ウィジェットのうち、map_when_managed が
.ZN True
であるものそれぞれをマップする。
.RE
.LP
.\"0 Managing children is independent of the ordering of children and
.\"0 independent of creating and deleting children.
子ウィジェットのマネージは、子ウィジェットの順序とは独立であり、子ウィ
ジェットの生成や破棄とも独立である。
.\"0 The layout routine of the parent
.\"0 should consider children whose managed field is
.\"0 .ZN True 
.\"0 and should ignore all other children.
親ウィジェットのレイアウトルーチンは, managed フィールドが
.ZN True 
である子ウィジェットを考慮に入れ、それ以外の子ウィジェットを全て無視す
る。
.\"0 Note that some composite widgets, especially fixed boxes, call
.\"0 .ZN XtManageChild
.\"0 from their insert_child procedure.
複合ウィジェットの中には(特に固定されたボックス)、insert_child 手続き
の中から
.ZN XtManageChild
を呼ぶものがある点に注意せよ。
.LP
.\"0 If the parent widget is realized,
.\"0 its change_managed procedure is called to notify it
.\"0 that its set of managed children has changed.
親ウィジェットがリアライズされていれば、マネージされている子ウィジェッ
トの集合が変化したことを通知するために、親ウィジェットの
change_managed 手続きが呼ばれる。
.\"0 The parent can reposition and resize any of its children.
これにより、親ウィジェットは子ウィジェットの再配置やサイズ変更を行うこ
とができる。
.\"0 It moves each child as needed by calling 
.\"0 .ZN XtMoveWidget ,
.\"0 which first updates the x and y fields and then calls
.\"0 .ZN XMoveWindow
.\"0 if the widget is realized.
親ウィジェットは、必要に応じて
.ZN XtMoveWidget
を呼んで、それぞれの子ウィジェットを動かすことができる。
この関数は、まず x, y フィールドを更新し、次に、このウィジェットがリア
ライズされていれば
.ZN XMoveWindow
を呼ぶ。
.LP
.\"0 The
.\"0 .ZN XtManageChild
.\"0 function constructs a
.\"0 .ZN WidgetList
.\"0 of length one and calls
.\"0 .ZN XtManageChildren .
関数
.ZN XtManageChild
は、長さが1の
.ZN WidgetList
を作り、
.ZN XtManageChildren
を呼ぶ。
.LP
.\"0 The
.\"0 .ZN XtUnmanageChildren
.\"0 function performs the following:
関数
.ZN XtUnmanageChildren
以下の動作を行う:
.IP \(bu 5
.\"0 Issues an error if the children do not all have the same parent
.\"0 or if the parent is not a subclass of 
.\"0 .ZN compositeWidgetClass .
親の異なる子ウィジェットが含まれる場合や親ウィジェットが
.ZN compositeWidgetClass
のサブクラスでない場合に、エラーを出す。
.IP \(bu 5
.\"0 Returns immediately if the common parent is being destroyed;
.\"0 otherwise, for each unique child on the list, 
.\"0 .ZN XtUnmanageChildren
.\"0 performs the following:
共通の親が破棄されようとしている場合は、即座に戻ってくる。そうでなけれ
ば、リスト中のユニークな子ウィジェットのそれぞれに対して、
.ZN XtUnmanageChildren
が以下の処理を行う:
.RS
.IP \- 5
.\"0 Ignores the child if it already is unmanaged or is being destroyed
.\"0 and marks it if not.
その子ウィジェットが既にマネージ解除されているか、破棄されようとしてい
る場合にはこれをを無視する。また、マークが付いていなければ、これにマー
クを付ける。
.IP \- 5
.\"0 If the child is realized,
.\"0 it makes it nonvisible by unmapping it.
子ウィジェットがリアライズされている場合、これはマップ解除によって不可
視の状態にされる。
.RE
.IP \(bu 5
.\"0 Calls the change_managed routine of the widgets' parent
.\"0 after all children have been marked
.\"0 if the parent is realized.
親ウィジェットがリアライズされていれば、全ての子ウィジェットにマークを
付け終った後で、親ウィジェットの change_managed 手続きを呼ぶ。
.LP
.\"0 .ZN XtUnmanageChildren
.\"0 does not destroy the children widgets.
.ZN XtUnmanageChildren
は、子ウィジェットを破棄することはない。
.\"0 Removing widgets from a parent's managed set is often a temporary banishment,
.\"0 and, some time later, you may manage the children again.
親ウィジェットのマネージセットからウィジェットを削除することは、一時的
にウィジェットを取り除いているだけのことが多い。この場合には、後で再び
子ウィジェットをマネージすることができる。
.LP
.\"0 The
.\"0 .ZN XtUnmanageChild
.\"0 function constructs a widget list
.\"0 of length one and calls
.\"0 .ZN XtUnmanageChildren .
関数
.ZN XtUnmanageChild
は、長さ1のウィジェットリストを作り、
.ZN XtUnmanageChildren
を呼び出す。
.LP
.\"0 The
.\"0 .ZN XtChangeManagedSet
.\"0 function performs the following:
.ZN XtChangeManagedSet
は、以下の動作を行う:
.IP \(bu 5
.\"0 Issues an error if the widgets specified in the \fImanage_children\fP
.\"0 and the \fIunmanage_children\fP lists to no all have the same parent, or
.\"0 if that parent is not a subclass of compositeWidgetClass.
\fImanage_children\fP リストと \fIunmanage_children\fP リストで指定さ
れたウィジェットに親の異なるものが含まれる場合や、親ウィジェットが
.ZN compositeWidgetClass
のサブクラスでない場合に、エラーを出す。
.IP \(bu 5
.\"0 Returns immediately if the common parent is being destroyed.
共通の親が破棄されようとしている場合は、即座に戻ってくる。
.IP \(bu 5
.\"0 If no
.\"0 .ZN CompositeClassExtension
.\"0 is defined, or a
.\"0 .ZN CompositeClassExtension
.\"0 is defined but with an \fIallows_change_managed_set\fP field with a
.\"0 value of
.\"0 .ZN False ,
.\"0 and
.\"0 .ZN XtChangeManagedSet 
.\"0 was invoked with a non-NULL \fIpost_unmanage_pre_manage_hook\fP procedure 
.\"0 then
.\"0 .ZN XtChangeManagedSet
.\"0 performs the following:
.ZN CompositeClassExtension
が定義されていない場合、または
.ZN CompositeClassExtension
は定義されているが \fIallows_change_managed_set\fP フィールドの値が
.ZN False
であり、かつ
.ZN XtChangeManagedSet 
が NULL でない \fIpost_unmanage_pre_manage_hook\fP 手続きを指定して呼
び出された場合には、
.ZN XtChangeManagedSet
は以下の動作を行う:
.RS
.IP \- 5
.\"0 Calls
.\"0 .ZN XtUnmanageChildren
.\"0 (\fIunmanage_children\fP, \fInum_unmanage_children\fP).
.ZN XtUnmanageChildren
(\fIunmanage_children\fP, \fInum_unmanage_children\fP)
を呼び出す。
.IP \- 5
.\"0 Calls the \fIpost_unmanage_pre_manage_hook\fP specified.
指定された \fIpost_unmanage_pre_manage_hook\fP を呼び出す。
.IP \- 5
.\"0 Calls
.\"0 .ZN XtManageChildren
.\"0 (\fImanage_children\fP, \fInum_manage_children\fP) and then returns
.\"0 immediately.
.ZN XtManageChildren
(\fImanage_children\fP, \fInum_manage_children\fP)
を呼び出し、その後すぐに戻る。
.RE
.IP \(bu 5
.\"0 Otherwise, if a
.\"0 .ZN CompositeClassExtension
.\"0 is defined with an \fIallows_change_managed_set\fP field with a value of
.\"0 .ZN True ,
.\"0 or if no
.\"0 .ZN CompositeClassExtension
.\"0 is defined, and
.\"0 .ZN XtChangeManagedSet was invoked with a NULL 
.\"0 \fIpost_unmanage_pre_manage_hook\fP procedure, then the following is
.\"0 performed:
そうでない場合で、\fIallows_change_managed_set\fP の値が
.ZN True
である
.ZN CompositeClassExtension
が定義されている場合、または
.ZN CompositeClassExtension
が定義されておらず、かつ NULL である
\fIpost_unmanage_pre_manage_hook\fP 手続きを使って
.ZN XtChangeManagedSet
が呼び出された場合には、以下の処理が行われる:
.RS
.IP \- 5
.\"0 For each child on the \fIunmanage_children\fP list; if the child is
.\"0 already unmanaged or is being destroyed it is ignored, otherwise it
.\"0 is marked as being unmanaged and if it is realized it is made nonvisible
.\"0 by being unmapped.
\fIunmanage_children\fP リストの子ウィジェットそれぞれについて処理を行
う。この子ウィジェットが既にマネージ解除されているか破棄されようとして
いる場合には、これは無視される。そうでない場合には、マネージ解除のマー
クが付けられ、さらにリアライズされている場合は、アンマップされて不可視
にされる。
.IP \- 5
.\"0 If the \fIpost_unmanage_pre_manage_hook\fP procdedure is non-NULL then
.\"0 it is invoked as specified.
\fIpost_unmanage_pre_manage_hook\fP 手続きが NULL でない場合、この手続
きが指定されたように呼び出される。
.IP \- 5
.\"0 For each child on the \fImanage_children\fP list; if the child is
.\"0 already managed or it is being destroyed it is ignored, otherwise it
.\"0 is marked as managed
\fImanage_children\fP リストの子ウィジェットそれぞれに対して処理を行う。
子ウィジェットが既にマネージされているか、破棄されようとしている場合に
は、これは無視される。そうでない場合には、マネージされるものとしてマー
クが付けられる。
.RE
.IP \(bu 5
.\"0 If the parent is realized and after all children have been marked, the
.\"0 change_managed method of the parent is invoked and subsequently some
.\"0 of the newly managed children are made viewable by:
親ウィジェットがリアライズされており、子ウィジェット全てにマークが付け
られた後ならば、まず親ウィジェットの change_managed 手続きが呼ばれ、続
いて以下の処理が行われることで、新しくマネージされた子ウィジェットの一
部が可視状態になる:
.RS
.IP \- 5
.\"0 Calling
.\"0 .ZN XtRealizeWidget
.\"0 on each of the previously unmanaged child that is unrealized.
以前にマネージ解除された子ウィジェットで、リアライズされていないものの
それぞれに対して
.ZN XtRealizeWidget
を呼ぶ。
.IP \- 5
.\"0 Mapping each previously unmanaged child that has \fImap_when_managed\fP
.\"0 .ZN True .
以前にマネージ解除された子ウィジェットで、\fImap_when_managed\fP が
.ZN True
であるものをそれぞれマップする。
.RE
.LP
.\"0 The
.\"0 .ZN XtIsManaged
.\"0 function returns
.\"0 .ZN True
.\"0 if the specified widget is of class RectObj or any subclass thereof and
.\"0 is managed, or
.\"0 .ZN False
.\"0 otherwise.
関数
.ZN XtIsManaged
は、
指定されたウィジェットがクラス RectObj かそのサブクラスであり、かつマ
ネージされている場合に
.ZN True
を返し、そうでない場合には
.ZN False
を返す。
.SH 関連項目
XtMapWidget(3Xt),
XtRealizeWidget(3Xt)
.br
\fI\*(xT\fP
.br
\fI\*(xL\fP