XmCreateSelectionDialog(3X) OSF XmCreateSelectionDialog(3X)
NAME
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 XmDIALOGSELECTION.
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
arglistSpecifies the argument list
argcount
Specifies the number of attribute/value pairs in the
argument list (arglist)
1 (printed 6/8/92)
XmCreateSelectionDialog(3X) OSF XmCreateSelectionDialog(3X)
For a complete definition of SelectionBox and its associated
resources, see XmSelectionBox(3X).
RETURN VALUE
Returns the SelectionBox widget ID.
RELATED INFORMATION
XmSelectionBox(3X).
2 (printed 6/8/92)