The Common Desktop Environment Motif Toolkit consists of the Motif 2.1 widget library with enhancements to existing functionality and bug fixes, as well as some new features.
In addition, it provides control widgets for graphical user interface objects not found in Motif 2.1. For more information on these widgets, see "Common Desktop Environment Motif Control Widgets" and the Solaris Common Desktop Environment: Programmer's Guide.
Common Desktop Environment Motif adds functionality to the Motif 2.1 release while maintaining backward binary compatibility. It is source and binary compatible with Motif 1.2 applications. Existing Motif 1.2 applications will compile using Common Desktop Environment Motif. Existing Motif 1.2 binaries will run without modification using Common Desktop Environment Motif.
The Common Desktop Environment added the following features to Motif 1.2.3 to support desktop applications:
Complete localization of toolkit error messages
XmGetPixmap() and XmGetPixmapByDepth() use the environment variable XMICONSEARCHPATH or XMICONBMSEARCHPATH as the icon search path. If neither of these variables is set, then they use XBLANGPATH, which is the Motif 1.2 behavior. See the Common Desktop Environment Motif man page for more information.
The Common Desktop Environment Xm library contains minor enhancements to Motif usability to enable better interoperability with OPEN LOOK and Microsoft Windows. The usability enhancements include:
Optionally allowing mouse button 2 on a three-button mouse to be used to extend the current selection. This is equivalent to the OPEN LOOK Adjust function.
Allowing Tab to be used to move through a group of PushButton widgets and gadgets, ArrowButton widget and gadgets, and DrawnButton widgets.
Allowing mouse button 3 to activate a CascadeButton menu.
Providing three new resources (pathMode, fileFilterStyle, and dirTextLabelString) for the XmFileSelectionBox widget, which give it an improved look and feel.
Enabling interoperability with Microsoft Windows and OPEN LOOK through multiple virtual key bindings.
Each of the preceding enhancements can be controlled by a resource: either a widget resource (for XmFileSelectionBox) or an application-wide resource (all other cases). The default values for this resource provide behavior and APIs that are identical to that of Motif 1.2. For information on these enhancements and resources, see the XmDisplay(3x) and XmFileSelectionBox(3x) man pages.
Use the Common Desktop Environment Motif and X11R5 libraries to develop a Common Desktop Environment Motif-compliant application for the X Window System. The Common Desktop Environment Motif libraries are the Motif 2.1 libraries with bug fixes and enhancements.
The Common Desktop Environment provides all the Motif 2.1 header files.
The Motif User Interface Language (UIL) is a specification language for describing the initial state of a Motif application's user interface. The Common Desktop Environment version is essentially unchanged from the Motif version.
Include the UilDef.h header file (found in the uil directory) to access UIL.
The Motif resource manager (MRM) is responsible for creating widgets based on definitions contained in User Interface Definition (UID) files created by the UIL compiler. MRM interprets the output of the UIL compiler and generates the appropriate argument lists for widget creation functions. Use libMrm to access the Motif resource manager. The Common Desktop Environment version is essentially unchanged from the Motif version.
Include the Mrm/MrmPublic.h header files to access libMrm in your application.
You can find Motif 1.2 demos in /usr/dt/examples/motif. These demos do not include any of the Common Desktop Environment Motif enhancements or widgets.
For more information on Motif, consult the Motif books listed in "Related Books". For more information on the enhancements to Motif 2.1, see the relevant man pages.