The Motif 2.1 Programmer's Reference contains the reference pages for Motif® commands and functions, including toolkit, window manager, and user interface language commands and functions.
This document is written for programmers who want to write applications by using Motif® interfaces. This document assumes that the reader is familiar with the American National Standards Institute (ANSI) C programming language. It also assumes that the reader has a general understanding of the X Window System, the Xlib library, and the X Toolkit Intrinsics (Xt).
This is Revision 2.1 of this document. It applies to Release 2.1 of the Motif® software system.
The purpose of this reference is to provide detailed descriptions of the Motif commands and functions.
This document is organized into one Alphabetic Listing of Motif Reference Information and four appendices:
The Alphabetic Listing of Motif Reference Information contains all the reference pages for the Motif commands and functions.
Appendix A contains a list of the constraint arguments and automatically created children for widgets available within UIL (User Interface Language).
Appendix B contains a list of the reasons and controls, or children, that UIL supports for each Motif Toolkit object.
Appendix C contains a list of the UIL arguments and their data types.
Appendix D contains a list of the UIL compiler diagnostics messages.
The reference pages in this volume use the following format:
PurposeThis section gives a short description of the interface.
SynopsisThis section describes the appropriate syntax for using the interface.
DescriptionThis section describes the behavior of the interface. On widget reference pages there are tables of resource values in the descriptions. These tables have the following headings:
| Name | Contains the name of the resource. Each new resource is described following the new resources table. |
| Class | Contains the class of the resource. |
| Type | Contains the type of the resource. |
| Default | Contains the default value of the resource. |
| Access | Contains the access permissions for the resource. A C in this column means the resource can be set at widget creation time. An S means the resource can be set anytime. A G means the resource's value can be retrieved. |
Examples
This sections gives practical examples for using the interface.Return Value
This section lists the values returned by function interfaces.
Errors
This section describes the error conditions associated with using this interface.
Related Information
This section provides cross-references to related interfaces and header files described within this document.
For additional information about Motif, refer to the following documents:
For additional information about Xlib and Xt, refer to the following X Window System documents:
This document uses the following typographic conventions:
Bold
Bold words or characters represent system elements that an application or user must use literally, such as functions, data types, commands, flags, and pathnames. Bold words also indicate the first use of a term included in the glossary.
Italic
Italic words or characters represent variable values and arguments that an application or user must supply.
Constant width
Examples and information that the system displays appear in this typeface.
< >
Angle brackets enclose the name of a key on the keyboard.
ComponentName
Components of the user interface are represented by uppercase letters for each major word in the name of the component, such as PushButton.