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

FreeBSD Manual Pages

  
 
  

home | help
XmVaCreateSimplePopupMenu(3Library Functions ManuaXmVaCreateSimplePopupMenu(3)

NAME
       XmVaCreateSimplePopupMenu  --  A	 RowColumn widget convenience creation
       function

SYNOPSIS
       #include	<Xm/RowColumn.h>
       Widget XmVaCreateSimplePopupMenu(
       Widget parent,
       String name,
       XtCallbackProc callback);

DESCRIPTION
       XmVaCreateSimplePopupMenu creates an instance of	a RowColumn widget  of
       type  XmMENU_POPUP  and returns the associated widget ID.  This routine
       uses the	ANSI C variable-length argument	list (varargs) calling conven-
       tion.

       This  routine  creates  a Popup menu pane and its button	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.  The	name of	each separator
       is separator_n, where n is an integer from 0 (zero) to  the  number  of
       separators  in  the  menu  minus	1.  The	name of	each title is label_n,
       where n is an integer from 0 (zero) to the number of titles in the menu
       minus  1.  Buttons, separators, and titles are named and	created	in the
       order in	which they are specified in the	variable portion of the	 argu-
       ment list.

       parent	 Specifies the widget ID of the	parent of the MenuShell

       name	 Specifies the name of the created widget

       callback	 Specifies  a callback procedure to be called when a button is
		 activated or when its value changes.  This callback  function
		 is added to each button after creation.  For a	CascadeButton-
		 Gadget	or a PushButtonGadget, the callback is	added  as  the
		 button's  XmNactivateCallback,	and it is called when the but-
		 ton is	activated.  For	a ToggleButtonGadget, the callback  is
		 added	as  the	 button's  XmNvalueChangedCallback,  and it is
		 called	when the button's value	changes.  The button number is
		 returned in the client_data field.

       The  variable  portion of the argument list consists of groups of argu-
       ments.  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.  The following list describes the	possible first
       arguments in each group of varargs.

       XmVaCASCADEBUTTON
		 This  is followed by two additional arguments.	The set	speci-
		 fies one button in the	PopupMenu and  some  of	 its  resource
		 values.  The button created is	a CascadeButtonGadget. Follow-
		 ing are the additional	two arguments, in order:

		 label	   The label string, of	type XmString

		 mnemonic  The mnemonic, of type KeySym

       XmVaPUSHBUTTON
		 This is followed by four additional arguments.	The set	speci-
		 fies  one  button  in	the PopupMenu and some of its resource
		 values. The button created is a  PushButtonGadget.  Following
		 are the additional four arguments, in order:

		 label	   The label string, of	type XmString

		 mnemonic  The mnemonic, of type KeySym

		 accelerator
			   The accelerator, of type String

		 accelerator_text
			   The accelerator text, of type XmString

       XmVaRADIOBUTTON
		 This is followed by four additional arguments.	The set	speci-
		 fies one button in the	PopupMenu and  some  of	 its  resource
		 values. The button created is a ToggleButtonGadget. Following
		 are the additional four arguments, in order:

		 label	   The label string, of	type XmString

		 mnemonic  The mnemonic, of type KeySym

		 accelerator
			   The accelerator, of type String

		 accelerator_text
			   The accelerator text, of type XmString

       XmVaCHECKBUTTON
		 This is followed by four additional arguments.	The set	speci-
		 fies  one  button  in	the PopupMenu and some of its resource
		 values. The button created is a ToggleButtonGadget. Following
		 are the additional four arguments, in order:

		 label	   The label string, of	type XmString

		 mnemonic  The mnemonic, of type KeySym

		 accelerator
			   The accelerator, of type String

		 accelerator_text
			   The accelerator text, of type XmString

       XmVaTITLE This  is followed by one additional argument. The pair	speci-
		 fies a	title LabelGadget in the PopupMenu. Following  is  the
		 additional argument:

		 title	   The title string, of	type XmString

       XmVaSEPARATOR
		 This is followed by no	additional arguments. It specifies one
		 separator in the PopupMenu.

       XmVaDOUBLE_SEPARATOR
		 This is followed by no	additional arguments. It specifies one
		 separator  in	the  PopupMenu.	 The  separator	type is	XmDOU-
		 BLE_LINE.

       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	speci-
		 fies a	resource and its value for the RowColumn widget. A re-
		 source	type conversion	is performed if	 necessary.  Following
		 are the additional 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  re-
		 turned	by XtVaCreateArgsList.

       For more	information on variable-length argument	lists, see the X Tool-
       kit 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(3).

RETURN
       Returns the RowColumn widget ID.

RELATED
       XmCreatePopupMenu(3), XmCreateRowColumn(3), XmCreateSimplePopupMenu(3),
       and XmRowColumn(3).

						  XmVaCreateSimplePopupMenu(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN | RELATED

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=XmVaCreateSimplePopupMenu&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help