Museum

 XmCreateSelectionDialog(Xm)    6 January 1993    XmCreateSelectionDialog(Xm)


 Name

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

    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)