ultrix man page for dwtpullentrygadgetcreate

DwtPullEntryGadgetCreate(3Dwt)											    DwtPullEntryGadgetCreate(3Dwt)

Name
       DwtPullEntryGadgetCreate - Creates a pull-down menu entry gadget.

Syntax
       Widget DwtPullEntryGadgetCreate (parent_widget, name,
					 override_arglist,
					 override_argcount)
	    Widget parent_widget;
	    char *name;
	    ArgList override_arglist;
	    int override_argcount;

Arguments
       parent_widget
		 Specifies the parent widget ID.

       name	 Specifies the name of the created widget.

       override_arglist
		 Specifies the application override argument list.

       override_argcount
		 Specifies the number of attributes in the application override argument list (override_arglist).

Description
       The DwtPullEntryGadgetCreate function creates an instance of the pull-down menu entry gadget and returns its associated gadget ID.

       A  pull-down menu entry gadget is similar in appearance and semantics to a pull-down menu entry widget.	Like all gadgets, it does not have
       a window but uses the window of the closest antecedent widget.  This gadget must be a child of a menu class widget.

       Because a pull-down menu entry gadget is not a subclass of composite, children are not supported.

       The sizing of the gadget is affected by the font and the label.

Inherited Attributes
       ---------------------------------------------------------
       Attribute Name	       Data Type	Default
       ---------------------------------------------------------
       Rectangle Attributes

       DwtNx		       Position 	Determined   by
						the    geometry
						manager
       DwtNy		       Position 	Determined   by
						the    geometry
						manager
       DwtNwidth	       Dimension	The	  label
						width, plus the
						hotspot  width,
						plus   2  times
						DwtNmarginWidth
       DwtNheight	       Dimension	The text  label
						or pixmap label
						height	plus  2
						times	  DwtN-
						marginHeight
       DwtNborderWidth	       Dimension	Zero pixels
       DwtNsensitive	       Boolean		True

       DwtNancestorSensitive   Boolean		The bitwise AND
						of  the  parent
						widget's
						DwtNsensitive
						and  DwtNances-
						torSensitive
						attributes

       Label	      Gadget
       Attributes

       DwtNlabel	       DwtCompString	Widget name
       DwtNalignment	       unsigned char	DwtAlignment-
						Center
       DwtNdirectionRToL       Boolean		False
       DwtNhelpCallback        DwtCallbackPtr	NULL
       ---------------------------------------------------------

Widget-Specific Attributes
       --------------------------------------------------------
       Attribute Name	      Data Type        Default
       --------------------------------------------------------
       DwtNsubMenuId	      Widget	       NULL
       DwtNactivateCallback   DwtCallbackPtr   NULL
       DwtNpullingCallback    DwtCallbackPtr   NULL
       --------------------------------------------------------

       DwtNsubMenuId  Specifies the widget ID of the submenu that will be displayed when the pull-down menu is activated.

       DwtNactivateCallback
		      Specifies the callback that is executed when the user releases a button inside the pull-down menu widget.   For  this  call-
		      back, the reason is DwtCRActivate.

       DwtNpullingCallback
		      Specifies  the  callback	function  or  functions  called just prior to pulling down the submenu.  This callback occurs just
		      before the submenu's map callback.  You can use this callback to defer the creation of the submenu.  For this callback,  the
		      reason is DwtCRActivate.

Return Values
       This function returns the ID of the created widget.

Callback Information
       The following structure is returned to your callback:
       typedef struct {
			   int reason;
			   XEvent *event;
       } DwtAnyCallbackStruct;

       The  reason member is set to a constant that represents the reason why this callback was invoked.  For this callback, the reason member can
       be set to:

       DwtCRActivate	    The  user  selected   the
			    pull-down menu entry.

       DwtCRHelpRequested   The user selected Help.

       The  event  member  is a pointer to the Xlib structure XEvent, which describes the event that generated this callback.  This structure is a
       union of the individual structures declared for each event type.  For information on XEvent and event processing, see the Guide to the Xlib
       Library: C Language Binding.

See Also
       DwtPullDownMenuEntry(3Dwt)
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

														    DwtPullEntryGadgetCreate(3Dwt)