Query: dwtpulldownmenuentry
OS: ultrix
Section: 3dwt
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
DwtPullDownMenuEntry(3Dwt) DwtPullDownMenuEntry(3Dwt) Name DwtPullDownMenuEntry, DwtPullDownMenuEntryCreate - Creates an instance of the pull-down menu entry widget. Syntax Widget DwtPullDownMenuEntry(parent_widget, name, x, y, label, menu_id, callback, help_callback) Widget parent_widget; char *name; Position x, y; DwtCompString label; Widget menu_id; DwtCallbackPtr callback, help_callback; Widget DwtPullDownMenuEntryCreate (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. x Specifies the placement, in pixels, of the left side of the widget window relative to the inner upper left corner of the parent window. This argument sets the DwtNx core widget attribute. y Specifies, in pixels, the placement of the upper left corner of the widget window relative to the inner upper left corner of the parent window. This argument sets the DwtNy core widget attribute. label Specifies the text of the label entry in the parent menu. This argument sets the DwtNlabel attribute associated with DwtLabel- Create. menu_id Specifies the ID of the pull-down menu widget. callback Specifies the callback function or functions called back when a button inside a pull-down menu entry widget is activated. This argument sets the DwtNactivateCallback and DwtNpullingCallback attributes associated with DwtPullDownMenuEntryCreate. help_callback Specifies the callback function or functions called when a help request is made. This argument sets the DwtNhelpCallback common widget attribute. 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 DwtPullDownMenuEntry and DwtPullDownMenuEntryCreate functions create an instance of the pull-down menu entry widget and return its associated widget ID. When calling DwtPullDownMenuEntry, you set the pull-down menu entry widget attributes presented in the formal param- eter list. For DwtPullDownMenuEntryCreate, however, you specify a list of attribute name/value pairs that represent all the possible pull- down menu entry widget attributes. A pull-down menu entry widget is made up of two parts: a label (within the parent menu) and a select area or ``hotspot.'' The hotspot is the full widget window. Otherwise, the hotspot is a separate rectangle on the right side of the entry label. Inherited Attributes ------------------------------------------------------------------ Attribute Name Data Type Default ------------------------------------------------------------------ Core Attributes DwtNx Position Determined by the geome- try manager DwtNy Position Determined by the geome- try manager DwtNwidth Dimension The DwtNlabel width, plus the DwtNhotSpot- Pixmap width or the Dwt- Npixmap width, plus Dwt- NmarginWidth times two DwtNheight Dimension The DwtNlabel or Dwt- Npixmap height, plus DwtNmarginHeight times two DwtNborderWidth Dimension zero pixels DwtNborder Pixel Default foreground color DwtNborderPixmap Pixmap NULL DwtNbackground Pixel Default background color DwtNbackgroundPixmap Pixmap NULL DwtNcolormap Colormap Default color map DwtNsensitive Boolean True DwtNancestorSensitive Boolean The bitwise AND of the parent widget's DwtNsen- sitive and DwtNances- torSensitive attributes DwtNaccelerators XtTranslations NULL DwtNdepth int Depth of the parent win- dow DwtNtranslations XtTranslations NULL DwtNmappedWhenManaged Boolean True DwtNscreen Screen * The parent screen DwtNdestroyCallback DwtCallbackPtr NULL Common Attributes DwtNforeground Pixel Default foreground color DwtNhighlight Pixel Default foreground color DwtNhighlightPixmap Pixmap NULL DwtNuserData Opaque * NULL DwtNdirectionRToL unsigned char DwtDirectionRightDown DwtNfont DwtFontList The default XUI Toolkit font DwtNhelpCallback DwtCallbackPtr NULL Label Attributes DwtNlabelType unsigned char DwtCString DwtNlabel DwtCompString Widget name DwtNmarginWidth Dimension Two pixels for text Zero pixels for pixmap DwtNmarginHeight Dimension Two pixels for text Zero pixels for pixmap DwtNalignment unsigned char DwtAlignmentCenter DwtNpixmap Pixmap NULL DwtNmarginLeft Dimension Zero DwtNmarginRight Dimension Zero DwtNmarginTop Dimension Zero DwtNmarginBottom Dimension Zero DwtNconformToText Boolean True, if the widget is created with a width and height of zero False, if the widget is created with a non-zero width and height ------------------------------------------------------------------ Widget-Specific Attributes You can set the following widget-specifc attributes in the override_arglist: -------------------------------------------------------- Attribute Name Data Type Default -------------------------------------------------------- DwtNsubMenuId Widget NULL DwtNactivateCallback DwtCallbackPtr NULL DwtNpullingCallback DwtCallbackPtr NULL DwtNhotSpotPixmap Pixmap 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. DwtNhotSpotPixmap Specifies the pixmap to use for the hotspot icon. Return Values These functions return 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 Guide to the XUI Toolkit: C Language Binding Guide to the XUI Toolkit Intrinsics: C Language Binding DwtPullDownMenuEntry(3Dwt)