'\" t ...\" VaCreE.sgm /main/9 1996/09/08 21:21:32 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 "XmVaCreateSimplePulldownMenu" "library call" .SH "NAME" \fBXmVaCreateSimplePulldownMenu\fP \(em A RowColumn widget convenience creation function .iX "XmVaCreateSimplePulldown\\%Menu" .iX "creation functions" "XmVaCreateSimplePulldown\\%Menu" .SH "SYNOPSIS" .PP .nf #include \fBWidget \fBXmVaCreateSimplePulldownMenu\fP\fR( \fBWidget \fBparent\fR\fR, \fBString \fBname\fR\fR, \fBint \fBpost_from_button\fR\fR, \fBXtCallbackProc \fBcallback\fR\fR); .fi .SH "DESCRIPTION" .PP \fBXmVaCreateSimplePulldownMenu\fP creates an instance of a RowColumn widget of type \fBXmMENU_PULLDOWN\fP and returns the associated widget ID\&. This routine uses the ANSI C variable-length argument list (\fIvarargs\fP) calling convention\&. .PP This routine creates a Pulldown menu pane and its button children\&. The name of each button is \fBbutton_\fP\fIn\fP, where \fIn\fP is an integer from 0 to the number of buttons in the menu minus 1\&. The name of each separator is \fBseparator_\fP\fIn\fP, where \fIn\fP is an integer from 0 to the number of separators in the menu minus 1\&. The name of each title is \fBlabel_\fP\fIn\fP, where \fIn\fP 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 argument list\&. .PP This routine also attaches the PulldownMenu to a CascadeButton or CascadeButtonGadget in the parent\&. The PulldownMenu is then posted from this button\&. .IP "\fIparent\fP" 10 Specifies the widget ID of the parent of the MenuShell\&. .IP "\fIname\fP" 10 Specifies the name of the created widget\&. .IP "\fIpost_from_button\fP" 10 Specifies the CascadeButton or CascadeButtonGadget in the parent to which the Pulldown menu pane is attached\&. The value is the integer \fIn\fP that corresponds to the \fIn\fPth CascadeButton or CascadeButtonGadget specified for the parent of the Pulldown menu pane\&. A Pulldown menu pane can be attached only to a CascadeButton or CascadeButtonGadget, and only CascadeButtons and CascadeButtonGadgets are counted in determining the integer \fIn\fP\&. The first CascadeButton or CascadeButtonGadget is number 0 (zero)\&. .IP "\fIcallback\fP" 10 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 CascadeButtonGadget or a PushButtonGadget, the callback is added as the button\&'s \fBXmNactivateCallback\fP, and it is called when the button is activated\&. For a ToggleButtonGadget, the callback is added as the button\&'s \fBXmNvalueChangedCallback\fP, and it is called when the button\&'s value changes\&. The button number is returned in the \fIclient_data\fP field\&. .PP 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 \fIvarargs\fP: .IP "\fBXmVaCASCADEBUTTON\fP" 10 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 CascadeButtonGadget\&. Following are the additional two arguments, in order: .RS .IP "\fIlabel\fP" 10 The label string, of type \fBXmString\fR .IP "\fImnemonic\fP" 10 The mnemonic, of type \fBKeySym\fP .RE .IP "\fBXmVaPUSHBUTTON\fP" 10 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 PushButtonGadget\&. Following are the additional four arguments, in order: .RS .IP "\fIlabel\fP" 10 The label string, of type \fBXmString\fR .IP "\fImnemonic\fP" 10 The mnemonic, of type \fBKeySym\fP .IP "\fIaccelerator\fP" 10 The accelerator, of type \fBString\fR .IP "\fIaccelerator_text\fP" 10 The accelerator text, of type \fBXmString\fR .RE .IP "\fBXmVaRADIOBUTTON\fP" 10 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 ToggleButtonGadget\&. Following are the additional four arguments, in order: .RS .IP "\fIlabel\fP" 10 The label string, of type \fBXmString\fR .IP "\fImnemonic\fP" 10 The mnemonic, of type \fBKeySym\fP .IP "\fIaccelerator\fP" 10 The accelerator, of type \fBString\fR .IP "\fIaccelerator_text\fP" 10 The accelerator text, of type \fBXmString\fR .RE .IP "\fBXmVaCHECKBUTTON\fP" 10 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 ToggleButtonGadget\&. Following are the additional four arguments, in order: .RS .IP "\fIlabel\fP" 10 The label string, of type \fBXmString\&.\fP .IP "\fImnemonic\fP" 10 The mnemonic, of type \fBKeySym\fP .IP "\fIaccelerator\fP" 10 The accelerator, of type \fBString\fR .IP "\fIaccelerator_text\fP" 10 The accelerator text, of type \fBXmString\fR .RE .IP "\fBXmVaTITLE\fP" 10 This is followed by one additional argument\&. The pair specifies a title LabelGadget in the PulldownMenu\&. Following is the additional argument: .RS .IP "\fItitle\fP" 10 The title string, of type \fBXmString\fR .RE .IP "\fBXmVaSEPARATOR\fP" 10 This is followed by no additional arguments\&. It specifies one separator in the PulldownMenu\&. .IP "\fBXmVaDOUBLE_SEPARATOR\fP" 10 This is followed by no additional arguments\&. It specifies one separator in the PulldownMenu\&. The separator type is \fBXmDOUBLE_LINE\fP\&. .IP "\fIresource_name\fP" 10 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\&. .IP "\fBXtVaTypedArg\fP" 10 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: .RS .IP "\fIname\fP" 10 The resource name, of type String\&. .IP "\fItype\fP" 10 The type of the resource value supplied, of type String\&. .IP "\fIvalue\fP" 10 The resource value (or a pointer to the resource value, depending on the type and size of the value), of type XtArgVal\&. .IP "\fIsize\fP" 10 The size of the resource value in bytes, of type int\&. .RE .IP "\fBXtVaNestedList\fP" 10 This is followed by one additional argument of type XtVarArgsList\&. This argument is a nested list of \fIvarargs\fP returned by \fBXtVaCreateArgsList\fP\&. .PP For more information on variable-length argument lists, see the X Toolkit Intrinsics documentation\&. .PP 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 \fBXmRowColumn\fP(3)\&. .SH "RETURN" .PP Returns the RowColumn widget ID\&. .SH "RELATED" .PP \fBXmCreatePulldownMenu\fP(3), \fBXmCreateRowColumn\fP(3), \fBXmCreateSimplePulldownMenu\fP, and \fBXmRowColumn\fP(3)\&. ...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:36