Files
cdesktop/cde/doc/C/guides/man/m3_Dt/MenuButt.sgm

514 lines
32 KiB
Plaintext

<!-- $XConsortium: MenuButt.sgm /main/10 1996/09/08 20:04:50 rws $ -->
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
<!-- (c) Copyright 1995 International Business Machines Corp. -->
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
<!-- (c) Copyright 1995 Novell, Inc. -->
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
<!-- (c) Copyright 1995 Hitachi. -->
<![ %CDE.C.CDE; [<RefEntry Id="CDEMX.XCDI.MAN48.rsml.1">]]><![ %CDE.C.XO; [<refentry
id="XCDI.MAN48.rsml.1">]]><refmeta><refentrytitle>DtMenuButton</refentrytitle>
<manvolnum>library call</manvolnum></refmeta><refnamediv><refname><classname>DtMenuButton</classname></refname><refpurpose>the MenuButton widget class
</refpurpose></refnamediv><!-- CDE Common Source Format, Version 1.0.0--><!--
(c) Copyright 1993, 1994, 1995 Hewlett-Packard Company--><!-- (c) Copyright
1993, 1994, 1995 International Business Machines Corp.--><!-- (c) Copyright
1993, 1994, 1995 Sun Microsystems, Inc.--><!-- (c) Copyright 1993, 1994, 1995
Novell, Inc.--><refsynopsisdiv>
<synopsis>#include &lt;Dt/MenuButton.h></synopsis>
</refsynopsisdiv><refsect1>
<title>DESCRIPTION</title>
<para>The DtMenuButton widget is a command widget that complements the menu
cascading functionality of an XmCascadeButton widget. As a complement to the
XmCascadeButton widget, DtMenuButton can only be instantiated outside a MenuPane;
the application must use XmCascadeButton widget inside a MenuPane.</para>
<para>The DtMenuButton widget belongs to a subclass of the XmLabel class.
Visually, the DtMenuButton widget consists of a label string and a menu glyph.
The menu glyph always appears on the right end of the widget and, by default,
is a downward pointing arrow.</para>
<para>The DtMenuButton widget has an implicitly created submenu attached to
it. The submenu <?Pub Caret>is a popup MenuPane and has this DtMenuButton
widget as its parent. The name of the implicitly created submenu is obtained
by adding <literal>submenu_</literal> as a prefix to the name of this DtMenuButton
widget. The widget ID of the submenu can be obtained by doing an <function>XtGetValues</function> on the <systemitem class="Resource">DtNsubMenuId</systemitem>
resource of this DtMenuButton widget. The implicitly created submenu must
not be destroyed by the user of this widget.</para>
<para>The submenu can be popped up by pressing the menu post Button (see the <systemitem class="Resource">XmNmenuPost</systemitem> resource of the <![ %CDE.C.CDE; [&cdeman.XmRowColumn; widget)
]]><![ %CDE.C.XO; [XmRowColumn widget) ]]>anywhere on the DtMenuButton widget.
</para>
<para>Widget subclassing is not supported for the DtMenuButton widget class.
</para>
<refsect2>
<title>Classes</title>
<para>The DtMenuButton widget inherits behavior and resources from the <classname>Core</classname>, <classname>Composite</classname>, <classname>XmPrimitive</classname> and <classname>XmLabel</classname> classes.</para>
<para>The class pointer is <Symbol>dtMenuButtonWidgetClass</Symbol>.</para>
<para>The class name is <structname role="typedef">DtMenuButtonWidget</structname>.
</para>
</refsect2>
<refsect2>
<title>New Resources</title>
<para>The following table defines a set of widget resources used by the application
to specify data. The application can also set the resource values for the
inherited classes to set attributes for this widget. To reference a resource
by name or by class in a <Filename>.Xdefaults</Filename> file, the application
must remove the <Symbol>DtN</Symbol> or <Symbol>DtC</Symbol> prefix and
use the remaining letters. To specify one of the defined values for a resource
in a <Filename>.Xdefaults</Filename> file, the application must remove the <symbol>Dt</symbol> prefix and use the remaining letters (in either lower case or
upper case, but including any underscores between words). The codes in the
access column indicate if the given resource can be set at creation time (C),
set by using <function>XtSetValues</function> (S), retrieved by using <function>XtGetValues</function> (G), or is not applicable (N/A).</para>
<informaltable>
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="7.78in">
<colspec align="left" colname="col1" colwidth="197*">
<colspec align="left" colname="col2" colwidth="140*">
<colspec align="left" colwidth="93*">
<colspec align="left" colwidth="135*">
<colspec align="left" colwidth="77*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>DtMenuButton Resource
Set</literal></entry></row>
<row>
<entry align="left" valign="top"><literal>Name</literal></entry>
<entry align="left" valign="top"><literal>Class</literal></entry>
<entry align="left" valign="top"><literal>Type</literal></entry>
<entry align="left" valign="top"><literal>Default</literal></entry>
<entry align="left" valign="top"><literal>Access</literal></entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">DtNcascadingCallback</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCCallback</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtCallbackList</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">C</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">DtNcascadePixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top"><systemitem class="Constant">XmUNSPECIFIED_PIXMAP</systemitem></entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">DtNsubMenuId</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCMenuWidget</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Widget</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">SG</entry></row></tbody></tgroup></informaltable>
<variablelist>
<varlistentry><term><systemitem class="Resource">DtNcascadingCallback</systemitem></term>
<listitem>
<para>Specifies the list of callbacks that is called before the popping up
of the attached submenu. The reason for the callback is <systemitem class="Constant">DtCR_CASCADING</systemitem>.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNcascadePixmap</systemitem></term>
<listitem>
<para>Specifies the pixmap displayed as the menu glyph. If no pixmap is specified,
a downward pointing arrow is displayed.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNsubMenuId</systemitem></term>
<listitem>
<para>Specifies the widget ID of the popup MenuPane to be associated with
this DtMenuButton widget. The popup MenuPane must be created with this DtMenuButton
as its parent. This resource cannot be specified at the time of widget creation.
The implicit submenu is automatically destroyed by DtMenuButton when this
resource is set.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>Inherited Resources</title>
<para>The DtMenuButton widget inherits behavior and resources from the following
named superclasses. For a complete description of each resource, see the <![ %CDE.C.CDE; [man page
]]><![ %CDE.C.XO; [entry in &str-ZM; ]]>for that superclass.</para>
<informaltable>
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="7.84in">
<colspec align="left" colname="col1" colwidth="190*">
<colspec align="left" colname="col2" colwidth="189*">
<colspec align="left" colwidth="100*">
<colspec align="left" colwidth="88*">
<colspec align="left" colwidth="80*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>XmLabel Resource
Set</literal></entry></row>
<row>
<entry align="left" valign="top"><literal>Name</literal></entry>
<entry align="left" valign="top"><literal>Class</literal></entry>
<entry align="left" valign="top"><literal>Type</literal></entry>
<entry align="left" valign="top"><literal>Default</literal></entry>
<entry align="left" valign="top"><literal>Access</literal></entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNaccelerator</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCAccelerator</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNacceleratorText</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCAcceleratorText</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XmString</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNalignment</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCAlignment</systemitem></entry>
<entry align="left" valign="top"><StructName Role="typedef">unsigned char</StructName></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNfontList</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCFontList</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XmFontList</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNlabelInsensitivePixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCLabelInsensitivePixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top"><systemitem class="Constant">XmUNSPECIFIED_PIXMAP</systemitem></entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNlabelPixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCLabelPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top"><systemitem class="Constant">XmUNSPECIFIED_PIXMAP</systemitem></entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNlabelString</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCXmString</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XmString</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNlabelType</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCLabelType</systemitem></entry>
<entry align="left" valign="top"><StructName Role="typedef">unsigned char</StructName></entry>
<entry align="left" valign="top">XmSTRING</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmarginBottom</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMarginBottom</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmarginHeight</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMarginHeight</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">2</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmarginLeft</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMarginLeft</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmarginRight</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMarginRight</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmarginTop</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMarginTop</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmarginWidth</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMarginWidth</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">2</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmnemonic</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMnemonic</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">KeySym</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmnemonicCharSet</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMnemonicCharSet</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">String</structname></entry>
<entry align="left" valign="top">XmFONTLIST-_DEFAULT_TAG</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNrecomputeSize</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCRecomputeSize</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">True</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNstringDirection</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCStringDirection</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XmStringDirection</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row></tbody></tgroup></informaltable>
<informaltable>
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="7.93in">
<colspec align="left" colname="col1" colwidth="206*">
<colspec align="left" colname="col2" colwidth="200*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="85*">
<colspec align="left" colwidth="79*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>XmPrimitive Resource
Set</literal></entry></row>
<row>
<entry align="left" valign="top"><literal>Name</literal></entry>
<entry align="left" valign="top"><literal>Class</literal></entry>
<entry align="left" valign="top"><literal>Type</literal></entry>
<entry align="left" valign="top"><literal>Default</literal></entry>
<entry align="left" valign="top"><literal>Access</literal></entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNbottomShadowColor</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCBottomShadowColor</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixel</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNbottomShadowPixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCBottomShadowPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top"><systemitem class="Constant">XmUNSPECIFIED_PIXMAP</systemitem></entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNforeground</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCForeground</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixel</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNhelpCallback</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCCallback</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtCallbackList</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">C</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNhighlightColor</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCHighlightColor</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixel</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNhighlightOnEnter</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCHighlightOnEnter</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">False</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNhighlightPixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCHighlightPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNhighlightThickness</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCHighlightThickness</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNnavigationType</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCNavigationType</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XmNavigationType</structname></entry>
<entry align="left" valign="top">XmNONE</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNshadowThickness</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCShadowThickness</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNtopShadowColor</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCTopShadowColor</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixel</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNtopShadowPixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCTopShadowPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNtraversalOn</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCTraversalOn</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">False</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNunitType</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCUnitType</systemitem></entry>
<entry align="left" valign="top"><StructName Role="typedef">unsigned char</StructName></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNuserData</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCUserData</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtPointer</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">CSG</entry></row></tbody></tgroup></informaltable>
<informaltable>
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="7.85in">
<colspec align="left" colname="col1" colwidth="197*">
<colspec align="left" colname="col2" colwidth="191*">
<colspec align="left" colwidth="91*">
<colspec align="left" colwidth="90*">
<colspec align="left" colwidth="79*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>Core Resource Set</literal></entry></row>
<row>
<entry align="left" valign="top"><literal>Name</literal></entry>
<entry align="left" valign="top"><literal>Class</literal></entry>
<entry align="left" valign="top"><literal>Type</literal></entry>
<entry align="left" valign="top"><literal>Default</literal></entry>
<entry align="left" valign="top"><literal>Access</literal></entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNaccelerators</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCAccelerators</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtAccelerators</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNancestorSensitive</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCSensitive</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">G</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNbackground</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCBackground</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixel</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNbackgroundPixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top"><systemitem class="Constant">XmUNSPECIFIED_PIXMAP</systemitem></entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNborderColor</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCBorderColor</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixel</structname></entry>
<entry align="left" valign="top">XtDefaultForeground</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNborderPixmap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCPixmap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Pixmap</structname></entry>
<entry align="left" valign="top"><systemitem class="Constant">XmUNSPECIFIED_PIXMAP</systemitem></entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNborderWidth</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCBorderWidth</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNcolormap</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCColormap</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Colormap</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNdepth</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCDepth</systemitem></entry>
<entry align="left" valign="top"><StructName Role="typedef">int</StructName></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNdestroyCallback</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCCallback</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtCallbackList</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">C</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNheight</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCHeight</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNinitialResourcesPersistent</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCInitialResourcesPersistent</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">True</entry>
<entry align="left" valign="top">C</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNmappedWhenManaged</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCMappedWhenManaged</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">True</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNscreen</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCScreen</systemitem></entry>
<entry align="left" valign="top"><StructName Role="typedef">Screen *</StructName></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNsensitive</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCSensitive</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Boolean</structname></entry>
<entry align="left" valign="top">True</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNtranslations</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCTranslations</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtTranslations</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNwidth</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCWidth</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Dimension</structname></entry>
<entry align="left" valign="top">dynamic</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNx</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCPosition</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Position</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNy</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCPosition</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Position</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">CSG</entry></row></tbody></tgroup></informaltable>
</refsect2>
<refsect2>
<title>Callback Information</title>
<para>A pointer to the following structure is passed to each DtMenuButton
callback:</para>
<informalexample remap="indent">
<programlisting>typedef struct {
int <symbol role="Variable">reason</symbol>;
XEvent *<symbol role="Variable">event</symbol>;
} XmAnyCallbackStruct;</programlisting>
</informalexample>
<para>The <symbol role="Variable">reason</symbol> argument indicates why the
callback was invoked; it is always <systemitem class="Constant">DtCR_CASCADING</systemitem> when the <systemitem class="Resource">DtNcascadingCallback</systemitem>
is issued.</para>
<para>The <symbol role="Variable">event</symbol> argument points to the <structname role="typedef">XEvent</structname> that triggered the callback or <systemitem class="Constant">NULL</systemitem> if the callback was not triggered by an <structname role="typedef">XEvent</structname>.</para>
</refsect2>
</refsect1><refsect1>
<title>SEE ALSO</title><![ %CDE.C.CDE; [<Para>&cdeman.DtCreateMenuButton;, &cdeman.Core;, &cdeman.XmLabel;, &cdeman.XmPrimitive;, &cdeman.XmRowColumn;, <Function>XtGetValues</Function>(3), <Function>XtSetValues</Function>(3).</Para>
]]><![ %CDE.C.XO; [<para>&cdeman.DtCreateMenuButton;; <classname>Core</classname>, <classname>XmLabel</classname>, <classname>XmPrimitive</classname>, <classname>XmRowColumn</classname>, in the &str-ZM;; <function>XtGetValues</function>, <function>XtSetValues</function> in the &str-Zt;.</para>]]></refsect1></refentry>
<!--fickle 1.12 mancsf-to-docbook 1.2 08/07/95 23:18:47-->
<?Pub *0000060897>