Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmVaCreateSimpleMenuBar(3)  Library Functions Manual  XmVaCreateSimpleMenuBar(3)

NAME
     XmVaCreateSimpleMenuBar -- A RowColumn widget convenience creation function

SYNOPSIS
     #include <Xm/RowColumn.h>
     Widget XmVaCreateSimpleMenuBar(
     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 (zero) to the
     number of buttons in the menu minus 1.  Buttons are named	and  created  in
     the  order in which they are specified in the variable portion of the argu-
     ment 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. Fol-
	       lowing are the additional two arguments, in 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 re-
	       source, 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 ad-
	       ditional four arguments, in 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 as-
     sociated resources, see XmRowColumn(3).

RETURN
     Returns the RowColumn widget ID.

RELATED
     XmCreateMenuBar(3), XmCreateRowColumn(3), XmCreateSimpleMenuBar(3), and Xm-
     RowColumn(3).

						      XmVaCreateSimpleMenuBar(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmVaCreateSimpleMenuBar&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help