[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmCreateSelectionBox

The SelectionBox widget creation function

Format

#include <Xm/SelectioB.h>
Widget XmCreateSelectionBox
Widget
parentString nameArgList
arglistCardinal argcount

DESCRIPTION

XmCreateSelectionBox creates an unmanaged SelectionBox. A SelectionBox is used to get a selection from a list of alternatives from the user and includes the following:

  1. A scrolling list of alternatives

  2. An editable text field for the selected alternative

  3. Labels for the list and text field

  4. Three or four buttons
  5. The default button labels are OK, Cancel , and Help . By default, an Apply button is also created. If the parent of the SelectionBox is a DialogShell, it is managed; otherwise it is unmanaged. Additional work area children may be added to the SelectionBox after creation.

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


    [ Previous | Next | Contents | Glossary | Home | Search ]