'\" 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 <Xm/RowColumn\&.h>
\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