Blob Blame History Raw
'\" t
...\" CreScD.sgm /main/8 1996/09/08 20:35:42 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 "XmCreateScrolledList" "library call"
.SH "NAME"
\fBXmCreateScrolledList\fP \(em The List ScrolledList convenience creation function
.iX "XmCreateScrolledList"
.iX "creation functions" "XmCreateScrolledList"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/List\&.h>
\fBWidget \fBXmCreateScrolledList\fP\fR(
\fBWidget \fBparent\fR\fR,
\fBString \fBname\fR\fR,
\fBArgList \fBarglist\fR\fR,
\fBCardinal \fBargcount\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmCreateScrolledList\fP creates an instance of a List widget
that is contained within a ScrolledWindow\&.
The ScrolledWindow parent is created managed\&.
All ScrolledWindow subarea
widgets are automatically created by this function\&.
The ID returned by this function is that of the List widget
(not the ScrolledWindow widget)\&.
Use this widget ID for all operations on the List widget\&.
Use the widget ID of the List widget\&'s parent for all operations
on the ScrolledWindow\&.
To obtain the ID of the ScrolledWindow widget associated with the List widget,
use the Xt Intrinsics \fBXtParent\fP function\&.
The name of the ScrolledWindow
created by this function is formed by concatenating \fBSW\fP
onto the end of the \fIname\fP specified in the parameter list\&.
.PP
All arguments to either the List or the ScrolledWindow widget can be
specified at creation time using this function\&.
Changes to initial position and size are sent only to the ScrolledWindow widget\&.
Other resources are sent to the List or the ScrolledWindow widget as appropriate\&.
Note that the result of providing the \fBXmNdestroyCallback\fP
resource in the creation \fIarglist\fP is unspecified\&. The
application should use the \fBXtAddCallback\fP function to add
callbacks to the appropriate widget (List or ScrolledWindow) after
creating it\&.
.PP
This function forces the following initial values for ScrolledWindow
resources:
.IP "   \(bu" 6
\fBXmNscrollingPolicy\fP is set to \fBXmAPPLICATION_DEFINED\fP\&.
.IP "   \(bu" 6
\fBXmNvisualPolicy\fP is set to \fBXmVARIABLE\fP\&.
.IP "   \(bu" 6
\fBXmNscrollBarDisplayPolicy\fP is set to \fBXmSTATIC\fP\&.
(No initial value is forced for the List\&'s
\fBXmNscrollBarDisplayPolicy\fP\&.)
.IP "   \(bu" 6
\fBXmNshadowThickness\fP is set to 0 (zero)\&.
.IP "\fIparent\fP" 10
Specifies the parent widget ID
.IP "\fIname\fP" 10
Specifies the name of the created widget
.IP "\fIarglist\fP" 10
Specifies the argument list
.IP "\fIargcount\fP" 10
Specifies the number of attribute/value pairs in the argument list
(\fIarglist\fP)
.PP
For a complete definition of List and its associated resources, see
\fBXmList\fP(3)\&.
.SH "RETURN"
.PP
Returns the List widget ID\&.
.SH "RELATED"
.PP
\fBXmList\fP(3) and \fBXmScrolledWindow\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:20