480 lines
29 KiB
Plaintext
480 lines
29 KiB
Plaintext
<!-- $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 <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>
|