'\" t
...\" ContainE.sgm /main/8 1996/09/08 20:31:53 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmContainerGetItemChildren" "library call"
.SH "NAME"
\fBXmContainerGetItemChildren\fP \(em Container widget function to find
all children of an item
.iX "XmContainerGetItemChildren"
.iX "XmContainer"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Container\&.h>
\fBint \fBXmContainerGetItemChildren\fP\fR(
\fBWidget \fBcontainer\fR\fR,
\fBWidget \fBitem\fR\fR,
\fBWidgetList * \fBitem_children\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmContainerGetItemChildren\fP allocates a WidgetList and stores within
it the widget IDs of all widgets that have \fIitem\fP specified as the value
of their \fBXmNentryParent\fP resource\&.
The application programmer is responsible for freeing the allocated
WidgetList using XtFree\&.
The number of widget IDs returned
in \fIitem_children\fP is returned by the function\&. If no widgets specify
\fIitem\fP as the value of their \fBXmNentryParent\fP resource,
the function returns zero and \fIitem_children\fP is left unchanged\&.
.IP "\fIcontainer\fP" 10
Specifies the Container widget ID\&.
.IP "\fIitem\fP" 10
Specifies a widgetID within \fIcontainer\fP\&.
.IP "\fIitem_children\fP" 10
Returned array of Widgets\&.
.PP
For a complete definition of Container and its associated resources, see
\fBXmContainer\fP(3)\&.
.SH "RETURN"
.PP
This function returns a count of all widgets that have \fIitem\fP
specified as the value of their \fBXmNentryParent\fP resource\&.
.SH "RELATED"
.PP
\fBXmContainer\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:19