XmVaCreateSimpleMenuBar(3X)
Prev | Reference Pages | Next

## Name

XmVaCreateSimpleMenuBar(3X) — XmVaCreateSimpleMenuBar--A RowColumn widget convenience creation function XmVaCreateSimpleMenuBarcreation functions

## Synopsis

#include <Xm/RowColumn.h>
Widget XmVaCreateSimpleMenuBar (`parent, name, arg...`)
Widget `parent`;
String `name`;

## DESCRIPTION

XmVaCreateSimpleMenuBar creates an instance of a RowColumn widget of type XmMENU_BAR and returns the associated widget ID. This routine uses the ANSI C variable-length argument list (varargs) calling convention.

This routine creates a MenuBar and its CascadeButtonGadget children. The name of each button is button_`n`, where `n` is an integer from 0 to one minus the number of buttons in the menu. Buttons are named and created in the order in which they are specified in the variable portion of the argument list.

`parent` |  | Specifies the parent widget ID
`name` |  | Specifies the name of the created widget

The variable portion of the argument list consists of groups of arguments. The first argument in each group is a constant or a string and determines which arguments follow in that group. The last argument in the list must be NULL. Following are the possible first arguments in each group of varargs:

XmVaCASCADEBUTTON |  | This is followed by two additional arguments. The set specifies one button in the MenuBar and some of its resource values. Following are the additional two arguments, in this order:
`label` |  | The label string, of type XmString.
`mnemonic` |  | The mnemonic, of type KeySym.
`resource_name` |  | This is followed by one additional argument, the value of the resource, of type XtArgVal. The pair specifies a resource and its value for the RowColumn widget.
XtVaTypedArg |  | This is followed by four additional arguments. The set specifies a resource and its value for the RowColumn widget. A resource type conversion is performed if necessary. Following are the additional four arguments, in this order:
`name` |  | The resource name, of type String.
`type` |  | The type of the resource value supplied, of type String.
`value` |  | The resource value (or a pointer to the resource value, depending on the type and size of the value), of type XtArgVal.
`size` |  | The size of the resource value in bytes, of type int.
XtVaNestedList |  | This is followed by one additional argument of type XtVarArgsList. This argument is a nested list of varargs returned by XtVaCreateArgsList.

For more information on variable-length argument lists, see the X Toolkit Intrinsics documentation.

A number of resources exist specifically for use with this and other simple menu creation routines. For a complete definition of RowColumn and its associated resources, see XmRowColumn(3X).

## RETURN VALUE

Returns the RowColumn widget ID.

## RELATED INFORMATION

XmCreateMenuBar(3X), XmCreateRowColumn(3X), XmCreateSimpleMenuBar(3X), and XmRowColumn(3X).

Prev | Table of Contents | Next
XmVaCreateSimpleCheckBox(3X) |  | XmVaCreateSimpleOptionMenu(3X)