Museum

 XmCreatePromptDialog(Xm)       6 January 1993       XmCreatePromptDialog(Xm)


 Name

    XmCreatePromptDialog - the SelectionBox PromptDialog convenience creation
    function

 Syntax


    #include <Xm/SelectioB.h>

    Widget XmCreatePromptDialog (parent, name, arglist, argcount)
    Widget parent;
    String name;
    ArgList arglist;
    Cardinal argcount;


 Description

    XmCreatePromptDialog is a convenience creation function that creates a
    DialogShell and an unmanaged SelectionBox child of the DialogShell.  A
    PromptDialog prompts the user for text input.  It includes a message, a
    text input region, and three managed buttons.  The default button labels
    are ``OK'', ``Cancel'', and ``Help''.  An additional button, with
    ``Apply'' as the default label, is created unmanaged; it may be explic-
    itly managed if needed.  One additional WorkArea child may be added to
    the SelectionBox after creation.

    XmCreatePromptDialog forces the value of the SelectionBox resource XmNdi-
    alogType to XmDIALOGPROMPT.

    Use XtManageChild to pop up the PromptDialog (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)