XmCreateScrolledList(3X)
Prev | Reference Pages | Next

## Name

XmCreateScrolledList(3X) — XmCreateScrolledList--The List ScrolledList convenience creation function XmCreateScrolledListcreation functions

## Synopsis

#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(3X).

## RETURN VALUE

Returns the List widget ID.

## RELATED INFORMATION

XmList(3X) and XmScrolledWindow(3X).

Prev | Table of Contents | Next
XmCreateScrollBar(3X) |  | XmCreateScrolledText(3X)