'\" t ...\" CrePuA.sgm /main/8 1996/09/08 20:34:44 rws $ .de P! .fl \!!1 setgray .fl \\&.\" .fl \!!0 setgray .fl \" force out current output buffer \!!save /psv exch def currentpoint translate 0 0 moveto \!!/showpage{}def .fl \" prolog .sy sed -e 's/^/!/' \\$1\" bring in postscript file \!!psv restore . .de pF .ie \\*(f1 .ds f1 \\n(.f .el .ie \\*(f2 .ds f2 \\n(.f .el .ie \\*(f3 .ds f3 \\n(.f .el .ie \\*(f4 .ds f4 \\n(.f .el .tm ? font overflow .ft \\$1 .. .de fP .ie !\\*(f4 \{\ . ft \\*(f4 . ds f4\" ' br \} .el .ie !\\*(f3 \{\ . ft \\*(f3 . ds f3\" ' br \} .el .ie !\\*(f2 \{\ . ft \\*(f2 . ds f2\" ' br \} .el .ie !\\*(f1 \{\ . ft \\*(f1 . ds f1\" ' br \} .el .tm ? font underflow .. .ds f1\" .ds f2\" .ds f3\" .ds f4\" .ta 8n 16n 24n 32n 40n 48n 56n 64n 72n .TH "XmCreatePulldownMenu" "library call" .SH "NAME" \fBXmCreatePulldownMenu\fP \(em A RowColumn widget convenience creation function .iX "XmCreatePulldownMenu" .iX "creation functions" "XmCreatePulldownMenu" .SH "SYNOPSIS" .PP .nf #include \fBWidget \fBXmCreatePulldownMenu\fP\fR( \fBWidget \fBparent\fR\fR, \fBString \fBname\fR\fR, \fBArgList \fBarglist\fR\fR, \fBCardinal \fBargcount\fR\fR); .fi .SH "DESCRIPTION" .PP \fBXmCreatePulldownMenu\fP creates an instance of a RowColumn widget of type \fBXmMENU_PULLDOWN\fP and returns the associated widget ID\&. .IP "\fIparent\fP" 10 Specifies the parent widget ID .IP "\fIname\fP" 10 Specifies the name of the created widget .IP "\fIarglist\fP" 10 Specifies the argument list .IP "\fIargcount\fP" 10 Specifies the number of attribute/value pairs in the argument list (\fIarglist\fP) .PP Specifies the number of attribute/value pairs in the argument list (\fIarglist\fP)\&. When this function is used to create the Pulldown menu pane, a MenuShell widget is automatically created as the parent of the menu pane\&. If the widget specified by the \fIparent\fP parameter is a Popup or a Pulldown menu pane, the MenuShell widget is created as a child of the \fIparent\fP MenuShell; otherwise, it is created as a child of the specified \fIparent\fP widget\&. .PP \fBXmCreatePulldownMenu\fP is provided as a convenience function for creating RowColumn widgets configured to operate as Pulldown menu panes and is not implemented as a separate widget class\&. .PP A Pulldown menu pane displays a 3-D shadow, unless the feature is disabled by the application\&. The shadow appears around the edge of the menu pane\&. .PP A Pulldown menu pane is used with submenus that are to be attached to a CascadeButton or a CascadeButtonGadget\&. This is the case for all menu panes that are part of a PulldownMenu system (a MenuBar), the menu pane associated with an OptionMenu, and any menu panes that cascade from a Popup menu pane\&. Pulldown menu panes that are to be associated with an OptionMenu must be created before the OptionMenu is created\&. .PP The Pulldown menu pane must be attached to a CascadeButton or CascadeButtonGadget that resides in a MenuBar, a Popup menu pane, a Pulldown menu pane, or an OptionMenu\&. It is attached with the button resource \fBXmNsubMenuId\fP\&. .PP A MenuShell widget is required between the Pulldown menu pane and its parent\&. If the application uses this convenience function for creating a Pulldown menu pane, the MenuShell is automatically created as the real parent of the menu pane; otherwise, it is the application\&'s responsibility to create the MenuShell widget\&. .PP To function correctly when incorporated into a menu, the Pulldown menu pane\&'s hierarchy must be considered\&. This hierarchy depends on the type of menu system that is being built, as follows: .IP " \(bu" 6 If the Pulldown menu pane is to be pulled down from a MenuBar, its \fIparent\fP must be the MenuBar\&. .IP " \(bu" 6 If the Pulldown menu pane is to be pulled down from a Popup or another Pulldown menu pane, its \fIparent\fP must be that Popup or Pulldown menu pane\&. .IP " \(bu" 6 If the Pulldown menu pane is to be pulled down from an OptionMenu, its \fIparent\fP must be the same as the OptionMenu parent\&. .PP PullDown menu panes support tear-off capabilities for tear-off menus through \fBXmRowColumn\fP resources\&. For a complete definition of RowColumn and its associated resources, see \fBXmRowColumn\fP(3)\&. .SH "RETURN" .PP Returns the RowColumn widget ID\&. .SH "RELATED" .PP \fBXmCascadeButton\fP(3), \fBXmCascadeButtonGadget\fP(3), \fBXmCreateOptionMenu\fP(3), \fBXmCreatePopupMenu\fP(3), \fBXmCreateSimplePulldownMenu\fP(3), \fBXmMenuShell\fP(3), \fBXmRowColumn\fP(3), and \fBXmVaCreateSimplePulldownMenu\fP(3)\&. ...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:20