XmCreatePromptDialog(library call)       XmCreatePromptDialog(library call)




 NAME    [Toc]    [Back]
      XmCreatePromptDialog - The SelectionBox PromptDialog convenience
      creation function

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/SelectioB.h>
      Widget XmCreatePromptDialog(
      Widget parent,
      String name,
      ArgList arglist,
      Cardinal argcount);

 DESCRIPTION    [Toc]    [Back]
      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 explicitly managed
      if needed. One additional WorkArea child may be added to the
      SelectionBox after creation.

      XmCreatePromptDialog forces the value of the SelectionBox resource
      XmNdialogType to XmDIALOG_PROMPT.

      Use XtManageChild to pop up the PromptDialog (passing the SelectionBox
      as the widget parameter); use XtUnmanageChild to pop it down.

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

      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    [Toc]    [Back]
      Returns the SelectionBox widget ID.

 RELATED    [Toc]    [Back]
      XmSelectionBox(3).


                                    - 1 -       Formatted:  January 24, 2005