Common Desktop Environment Motif Control Widgets

The Common Desktop Environment Motif control widgets are designed to ease porting OPEN LOOK and Microsoft Windows applications to the Common Desktop Environment by providing equivalent functionality in Common Desktop Environment Motif. The Common Desktop Environment Motif widgets library libDtWidget contains widgets and functions that are used to provide common functionality across all Common Desktop Environment applications. The widgets provided include:

• Text field and arrow button widget (DtSpinBox)

  Figure 7-1 Example of text field and arrow button widget (DtSpinBox)

  
  

• Text field and list box widget (DtComboBox)

  Figure 7-2 Examples of text field and list box widget (DtComboBox)

  
  

• Menu button widget (DtMenuButton)

  Figure 7-3 Example of menu button widget (DtMenuButton)

  
  

The Common Desktop Environment Motif Widget library libDtWidget supports drivability between Common Desktop Environment applications and legacy OPEN LOOK applications. That is, it enables you to write applications that operate the same way OPEN LOOK applications do, in areas such as cut, copy, paste, and mouse-button functionality.

---

Note -

The Common Desktop Environment supports all Motif 1.2 widgets. See Appendix A, Common Desktop Environment Motif for more information on Common Desktop Environment Motif.

---

Table 7-1 Common Desktop Environment Control Widgets

Widget Name	Description
DtSpinBox	TextField widget with additional controls for incrementing and decrementing numeric values, or browsing through and selecting from a list of text strings
DtComboBox	Combination of TextField and pop-up List widgets that provides a list of valid choices for the TextField
DtMenuButton	Command widget that provides menu cascading functionality of an XmCascadeButton widget outside of a Menu Bar, or a Menu Pane (a pull-down menu, a pop-up menu, or an option menu)

Compatibility with Motif 2.1

The APIs of the DtSpinBox and DtComboBox widgets are similar to the Motif 2.1 release of XmSpinBox and XmComboBox widgets. The APIs are designed so an application can easily switch to the Motif 2.1 version of these widgets. To switch, change the Dt names for the class, types, and creation routines to Xm. For example, change all occurrences of DtSpinBox in your code to XmSpinBox. This information is supplied in case you choose to port your application to Motif 2.1, but it is not a recommendation that you do so.

---

Note -

The Common Desktop Environment does not guarantee strict API or binary compatibility between its widgets and the Motif 2.1 widgets.

---

Library and Header Files

The library libDtWidget provides access to the DtSpinBox, DtComboBox, and DtMenuButton widgets. The libDtWidget header files for these widgets are:

• Dt/SpinBox.h

• Dt/ComboBox.h

• Dt/MenuButton.h

Demo Programs

You can find the Common Desktop Environment Motif control widgets demos in /usr/dt/examples/dtwidget. Read the README file for detailed information on the demos.

Related Documentation

For more information on Common Desktop Environment Motif control widgets, see the relevant man pages and the Solaris Common Desktop Environment: Programmer's Guide.