XmCreateScrolledList(Xm)
XmCreateScrolledList --
the List ScrolledList convenience creation function
Syntax
#include <Xm/List.h>
Widget XmCreateScrolledList (parent, name, arglist, argcount)
Widget parent;
String name;
ArgList arglist;
Cardinal argcount;
Description
XmCreateScrolledList creates an instance of a List widget
that is contained within a ScrolledWindow. All ScrolledWindow subarea
widgets are automatically created by this function. The ID returned
by this function is that of the List widget.
Use this ID for all normal List operations, as well as those that
are relevant for the ScrolledList widget.
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.
This function forces the following initial values for ScrolledWindow
resources:
-
XmNscrollingPolicy is set to XmAPPLICATION_DEFINED.
-
XmNvisualPolicy is set to XmVARIABLE.
-
XmNscrollBarDisplayPolicy is set to XmSTATIC.
(No initial value is forced for the List's
XmNscrollBarDisplayPolicy.)
-
XmNshadowThickness is set to 0.
To obtain the ID of the
ScrolledWindow widget associated with the ScrolledList, use
the Xt Intrinsics XtParent function.
The name of the ScrolledWindow
created by this function is formed by concatenating the letters ``SW''
onto the end of the name specified in the parameter list.
parent-
Specifies the parent widget ID
name-
Specifies the name of the created widget
arglist-
Specifies the argument list
argcount-
Specifies the number of attribute/value pairs in the argument list
(arglist)
For a complete definition of List and its associated resources, see
XmList(Xm).
Return value
Returns the List widget ID.
See also
XmList(Xm)
and
XmScrolledWindow(Xm).
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003