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)