👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

RedHat 9 (Linux i386) - man page for xmvacreatesimplepulldownmenu (redhat section 3)

XmVaCreateSimplePulldownMenu(library call)	       XmVaCreateSimplePulldownMenu(library call)

NAME
       XmVaCreateSimplePulldownMenu -- A RowColumn widget convenience creation function

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

DESCRIPTION
       XmVaCreateSimplePulldownMenu   creates	an   instance  of  a  RowColumn  widget  of  type
       XmMENU_PULLDOWN and returns the associated widget ID.  This routine uses the ANSI C  vari-
       able-length argument list (varargs) calling convention.

       This  routine creates a Pulldown menu pane and its button children.  The name of each but-
       ton is button_n, where n is an integer from 0 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 to the number
       of separators in the menu minus 1.  The name of each title is label_n, where n is an inte-
       ger  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 por-
       tion of the argument list.

       This  routine  also attaches the PulldownMenu to a CascadeButton or CascadeButtonGadget in
       the parent.  The PulldownMenu is then posted from this button.

       parent	 Specifies the widget ID of the parent of the MenuShell.

       name	 Specifies the name of the created widget.

       post_from_button
		 Specifies the CascadeButton or CascadeButtonGadget in the parent  to  which  the
		 Pulldown  menu pane is attached.  The value is the integer n that corresponds to
		 the nth CascadeButton or CascadeButtonGadget specified for  the  parent  of  the
		 Pulldown  menu pane.  A Pulldown menu pane can be attached only to a CascadeBut-
		 ton or CascadeButtonGadget, and only CascadeButtons and CascadeButtonGadgets are
		 counted in determining the integer n.	The first CascadeButton or CascadeButton-
		 Gadget is number 0 (zero).

       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 cre-
		 ation.  For a CascadeButtonGadget or a PushButtonGadget, the callback	is  added
		 as  the  button's XmNactivateCallback, and it is called when the button is acti-
		 vated.  For a ToggleButtonGadget, the callback is added as the button's  XmNval-
		 ueChangedCallback, 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  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 PulldownMenu and some of its resource values. The button created is  a  Cas-
		 cadeButtonGadget. Following 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 specifies one button in
		 the PulldownMenu and some of its resource values. The button created is a  Push-
		 ButtonGadget. 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 specifies one button in
		 the PulldownMenu and some of its resource values. The button created is  a  Tog-
		 gleButtonGadget. 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 specifies one button in
		 the PulldownMenu and some of its resource values. The button created is  a  Tog-
		 gleButtonGadget. 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 specifies a title Label-
		 Gadget in the PulldownMenu. 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
		 PulldownMenu.

       XmVaDOUBLE_SEPARATOR
		 This  is  followed by no additional arguments. It specifies one separator in the
		 PulldownMenu. The separator type is XmDOUBLE_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 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 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 docu-
       mentation.

       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 XmRow-
       Column(3).

RETURN
       Returns the RowColumn widget ID.

RELATED
       XmCreatePulldownMenu(3), XmCreateRowColumn(3), XmCreateSimplePulldownMenu,  and	XmRowCol-
       umn(3).

						       XmVaCreateSimplePulldownMenu(library call)


All times are GMT -4. The time now is 06:43 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password