HP OpenVMS Systems Documentation

Digital includes the following files to support WML databases on UNIX and Windows NT operating systems:

• motif.wml specifies the Motif toolkit as shipped from the OSF.
• dxm-motif.wml describes the OSF/Motif toolkit with the additional Digital extensions.

When adding new widgets or changing widget characteristics, start with a copy of one of the two WML files. Use dxm-motif.wml if you are using any Digital widgets. Use the motif.wml files if your application requires a strict OSF/Motif widget set.

Digital has also included the following two WMD files (which correspond to the two WML files):

• motif.wmd specifies the Motif toolkit as shipped from the OSF.
• dxm-motif.wmd describes the OSF/Motif toolkit with the Digital extensions to the toolkit.

To allow you to add UIL support for additional widgets, Digital has provided you with the following files for UNIX and Windows NT systems:

• Templates (found in /usr/examples/motif/wml)

  motif.wml
  dxm-motif.wml

  Use either of the previous files as a template for your own wml file.

  
  

• wmldbcreate.c
• A script file

To add UIL support for additional widgets, follow these steps:

1. Copy the wml files into your directory.
2. Extend the wml file to add support for your new widgets.
3. Add your widget's public include file to the wmldbcreate.c file.
4. Execute the script file by entering a command in following format:

   xmkmf filename

5. Issue the make all command to produce the makefile. This makefile performs three major functions:
   1. Runs wml to create .h files.
   2. Compiles, links, and runs a modified wmldbcreate.c.
   3. Cleans up. (If the command procedure does not finish successfully, it will not clean up the extra files generated. Delete any extra files before running the command procedure again.)
   
   After you execute this script file, you will have a wmd file that the UIL compiler will use instead of the internal database.
   An mm documentation file is created. This file is a troff mm macro format file. You can use the mm file on UNIX systems to create a copy of the UIL built-in tables for your own widget set.
6. Invoke the UIL compiler by entering a command in the following format:

   uil -d filenamenew.wmd filename.uil -o filename.uid

This appendix lists all the UIL built-in tables used to check that your UIL specification is consistent with the DECwindows Motif Toolkit. The Digital specific arguments are listed first in each table, followed by the OSF/Motif arguments.

For each object in the DECwindows Motif toolkit, this appendix contains a table that lists the reasons, controls (children), and arguments (widget resources) that UIL supports. It also lists the data type and default value of each supported argument.

The default values have been included to indicate the behavior of the object when you do not specify particular arguments in the UIL module. For example, if you do not specify the highlight color for an object, the object is displayed with black as the highlight color.

The UIL name for an argument is identical to the DECwindows Motif Toolkit name for that argument. Callback resources in the DECwindows Motif Toolkit are represented by reasons in UIL. In cases where the DECwindows Motif toolkit resource name is a UIL keyword, the UIL name for the argument has been configured to avoid ambiguity; the argument name is appended to the object name (or an abbreviated form of it).

Some arguments take a symbolic reference to a widget as their value. These arguments are denoted by the term object reference in the type column for the argument. To specify a symbolic reference to a widget ID, supply the type and name of an object that is defined in your UIL module.

For example:

     arguments {
          XmNdefaultButton = XmPushButton My_push_button;
     };

A.1 DXmColorMix