XmCreateSelectionDialog(library call)									     XmCreateSelectionDialog(library call)

NAME

       XmCreateSelectionDialog -- The SelectionBox SelectionDialog convenience creation function

SYNOPSIS

       #include <Xm/SelectioB.h>
       Widget XmCreateSelectionDialog(
       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:

	  o  A scrolling list of alternatives

	  o  An editable text field for the selected alternative

	  o  Labels for the text field

	  o  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.

       XmCreateSelectionDialog forces the value of the Shell resource XmNallowShellResize to True.

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

RETURN

       Returns the SelectionBox widget ID.

RELATED

       XmSelectionBox(3).

													     XmCreateSelectionDialog(library call)