<!-- $XConsortium: ComboBox.sgm /main/16 1996/09/08 20:02:24 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.MAN14.rsml.1">]]><![ %CDE.C.XO; [<refentry
id="XCDI.MAN14.rsml.1">]]><refmeta><refentrytitle>DtComboBox</refentrytitle>
<manvolnum>library call</manvolnum></refmeta><refnamediv><refname><classname>DtComboBox</classname></refname><refpurpose>the ComboBox 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.--><!-- (c) Copyright 1993, 1994, 1995 Interleaf, Inc.--><refsynopsisdiv>
<synopsis>#include &lt;Dt/ComboBox.h></synopsis>
</refsynopsisdiv><refsect1>
<title>DESCRIPTION</title>
<note><para>This function has been superseded by the equivalent
Motif function <function>XmComboBox</function>. Please refer to the
<![ %CDE.C.CDE; [<emphasis>Motif Programmer's Reference</emphasis>]]><![ %CDE.C.XO; [&str-ZM;]]> for more information.
</para>
</note>
<para>The DtComboBox widget is a combination of a TextField and a List widget
that provides a list of valid choices for the TextField. Selecting an item
from this list automatically fills in the TextField with that list item.</para>
<para>Widget subclassing is not supported for the DtComboBox widget class.
</para>
<para>The resources for the XmList and XmTextField widgets that are created
by the DtComboBox are accessible by using the <function>XtNameToWidget</function>(3)
function. The names of these widgets are <literal>*List</literal> and <literal>Text</literal>, respectively. (The <literal>*List</literal> notation is required
because the List widget is not an immediate descendant of the DtComboBox.
See <![ %CDE.C.CDE; [<Function>XtNameToWidget</Function>(3)]]><![ %CDE.C.XO; [<function>XtNameToWidget</function> in the &str-Zt;]]>.)</para>
<refsect2>
<title>Classes</title>
<para>The DtComboBox widget inherits behavior and resources from the <classname>Core</classname>, <classname>Composite</classname> and <classname>XmManager</classname> classes.</para>
<para>The class pointer is <Symbol>dtComboBoxWidgetClass</Symbol>.</para>
<para>The class name is <structname role="typedef">DtComboBoxWidget</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.46in">
<colspec align="left" colname="col1" colwidth="196*">
<colspec align="left" colname="col2" colwidth="193*">
<colspec align="left" colwidth="88*">
<colspec align="left" colwidth="77*">
<colspec align="left" colwidth="62*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>DtComboBox 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">DtNmarginHeight</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCMarginHeight</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">DtNmarginWidth</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCMarginWidth</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">DtNselectedItem</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCSelectedItem</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">DtNselectedPosition</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCSelectedPosition</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">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">DtNselectionCallback</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">DtNcomboBoxType</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">DtCComboBoxType</systemitem></entry>
<entry align="left" valign="top"><StructName Role="typedef">unsigned int</StructName></entry>
<entry align="left" valign="top">DtDROP_DOWN_LIST</entry>
<entry align="left" valign="top">C</entry></row></tbody></tgroup></informaltable>
<variablelist>
<varlistentry><term><systemitem class="Resource">DtNmarginHeight</systemitem></term>
<listitem>
<para>Specifies the number of pixels added between the top and bottom of the
text widget and the start of the shadow.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNmarginWidth</systemitem></term>
<listitem>
<para>Specifies the number of pixels added between the right and left sides
of the text widget and the start of the shadow.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNselectedItem</systemitem></term>
<listitem>
<para>This resource is passed through to the XmList to set the <systemitem class="Resource">XmNselectedItemCount</systemitem> and <systemitem class="Resource">XmNselectedItems</systemitem> as the single item in the <systemitem class="Resource">XmNitems</systemitem> that matches this specified <structname role="typedef">XmString</structname> in the List. Setting both <systemitem class="Resource">DtNselectedItem</systemitem> and <systemitem class="Resource">DtNselectedPosition</systemitem> in the same argument list produces undefined behavior.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNselectedPosition</systemitem></term>
<listitem>
<para>This resource is passed through to the XmList to set the <systemitem class="Resource">XmNselectedItemCount</systemitem> and <systemitem class="Resource">XmNselectedItems</systemitem> as the single item at this specified position
in the List. Setting both <systemitem class="Resource">DtNselectedItem</systemitem>
and <systemitem class="Resource">DtNselectedPosition</systemitem> in the same
argument list produces undefined behavior.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNselectionCallback</systemitem></term>
<listitem>
<para>This callback list is issued when an item is selected from the DtComboBox
widget's List. The <symbol role="Variable">call_data</symbol> structure contains
a <structname role="typedef">DtComboBoxCallbackStruct</structname> with the
reason <systemitem class="Constant">DtCR_SELECT</systemitem>.</para>
</listitem>
</varlistentry>
<varlistentry><term><systemitem class="Resource">DtNcomboBoxType</systemitem></term>
<listitem>
<para>This resource determines the style of the DtComboBox. There are two
choices:</para>
<variablelist>
<varlistentry><term>DtDROP_DOWN_COMBO_BOX</term>
<listitem>
<para>Provides an editable text area.</para>
</listitem>
</varlistentry>
<varlistentry><term>DtDROP_DOWN_LIST</term>
<listitem>
<para>Provides a static text area.</para>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</refsect2>
<refsect2>
<title>Inherited Resources</title>
<para>The DtComboBox 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.73in">
<colspec align="left" colname="col1" colwidth="182*">
<colspec align="left" colname="col2" colwidth="186*">
<colspec align="left" colwidth="109*">
<colspec align="left" colwidth="91*">
<colspec align="left" colwidth="70*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>XmManager  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">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">XmNinitialFocus</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCInitialFocus</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">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">dynamic</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">dynamic</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">CG</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">dynamic</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.46in">
<colspec align="left" colname="col1" colwidth="176*">
<colspec align="left" colname="col2" colwidth="178*">
<colspec align="left" colwidth="90*">
<colspec align="left" colwidth="95*">
<colspec align="left" colwidth="77*">
<spanspec nameend="col2" namest="col1" spanname="1to2">
<tbody>
<row>
<entry align="left" spanname="1to2" valign="top"><literal>Composite  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">XmNchildren</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCReadOnly</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">WidgetList</structname></entry>
<entry align="left" valign="top">NULL</entry>
<entry align="left" valign="top">G</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNinsertPosition</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCInsertPosition</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">XtOrderProc</structname></entry>
<entry align="left" valign="top">default procedure</entry>
<entry align="left" valign="top">CSG</entry></row>
<row>
<entry align="left" valign="top"><systemitem class="Resource">XmNnumChildren</systemitem></entry>
<entry align="left" valign="top"><systemitem class="Resource">XmCReadOnly</systemitem></entry>
<entry align="left" valign="top"><structname role="typedef">Cardinal</structname></entry>
<entry align="left" valign="top">0</entry>
<entry align="left" valign="top">G</entry></row></tbody></tgroup></informaltable>
<informaltable>
<tgroup cols="5" colsep="0" rowsep="0">
<?PubTbl tgroup dispwid="7.85in">
<colspec align="left" colname="col1" colwidth="196*">
<colspec align="left" colname="col2" colwidth="193*">
<colspec align="left" colwidth="90*">
<colspec align="left" colwidth="99*">
<colspec align="left" colwidth="70*">
<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>
<?PubTbl row rht="0.39in" >
<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><?Pub Caret>
</informaltable>
</refsect2>
<refsect2>
<title>Callback Information</title>
<para>A pointer to the following structure is passed to each DtComboBox callback:
</para>
<informalexample remap="indent">
<programlisting>typedef struct {
        int             <symbol role="Variable">reason</symbol>;
        XEvent          *<symbol role="Variable">event</symbol>;
        XmString        <symbol role="Variable">item_or_text</symbol>;
        int             <symbol role="Variable">item_position</symbol>;
} DtComboBoxCallbackStruct;</programlisting>
</informalexample>
<para>The <symbol role="Variable">reason</symbol> argument indicates why the
callback was invoked; it is always <systemitem class="Constant">DtCR_SELECT</systemitem>.</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>
<para>The <symbol role="Variable">item_or_text</symbol> argument is the contents
of the Text widget at the time the event caused the callback to be invoked.
This data is only valid within the scope of the <symbol role="Variable">call_data</symbol>
structure, so the application must copy it when it is used outside
of this scope.</para>
<para>The <symbol role="Variable">item_position</symbol> argument is the new
value of the <systemitem class="Resource">DtNselectedPosition</systemitem>
resource in the DtComboBox's List. If this is zero, it means the user entered
a value in the XmTextField widget.</para>
</refsect2>
</refsect1><refsect1>
<title>SEE ALSO</title>
<para>&cdeman.DtComboBoxAddItem;, &cdeman.DtComboBoxDeletePos;, &cdeman.DtComboBoxSelectItem;, &cdeman.DtComboBoxSetItem;, <![ %CDE.C.CDE; [&cdeman.DtCreateComboBox;, &cdeman.Composite;, &cdeman.Constraint;, &cdeman.Core;, &cdeman.XmList;, &cdeman.XmManager;, &cdeman.XmText;, &cdeman.XmTextField;, <Function>XtGetValues</Function>(3), <Function>XtSetValues</Function>(3). ]]><![ %CDE.C.XO; [&cdeman.DtCreateComboBox;; <classname>Composite</classname>, <classname>Constraint</classname>, <classname>Core</classname>, <classname>XmList</classname>, <classname>XmManager</classname>, <classname>XmText</classname>, <classname>XmTextField</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 *0000058803>
