XmCreateSelectionDialog(Xm)
XmCreateSelectionDialog --
the SelectionBox SelectionDialog convenience creation function
Syntax
#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(Xm).
Return value
Returns the SelectionBox widget ID.
See also
XmSelectionBox(Xm)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003