XmCreateSelectionDialog(X3mot)

XmCreateSelectionDialog -- the SelectionBox SelectionDialog convenience creation function

Synopsis

#include <Xm/SelectioB.h>

Widget XmCreateSelectionDialog (parent, name, arglist, argcount)
Widget parent;
String name;
ArgList arglist;
Cardinal argcount;

Description

XmCreateSelectionDialog is a convenience creation function that creates a DialogShell and an unmanaged SelectionBox child of the DialogShell. A SelectionDialog offers the user a choice from a list of alternatives and gets a selection. It includes the following:

A scrolling list of alternatives
An editable text field for the selected alternative
Labels for the text field
Four buttons

The default button labels are ``OK'', ``Cancel'', ``Apply'', and ``Help''. One additional WorkArea child may be added to the SelectionBox after creation.

XmCreateSelectionDialog forces the value of the SelectionBox resource XmNdialogType to XmDIALOG_SELECTION.

Use XtManageChild to pop up the SelectionDialog (passing the SelectionBox as the widget parameter); use XtUnmanageChild to pop it down.

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 SelectionBox and its associated resources, see XmSelectionBox(X3mot).

Return values

Returns the SelectionBox widget ID.

References

XmSelectionBox(X3mot)