DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH
 

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:

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