CONTENTS Title Page Copyright Page Preface Part I Guide to the DECwindows ToolKit 1 Overview of the DECwindows Toolkit 1.1 DECwindows Toolkit Components 1.2 User Interface Widgets 1.3 Creating a User Interface 1.4 Calling Back to Application Functions 2 Creating a User Interface 2.1 A Sample DECwindows Application 2.2 The User Interface Language 2.3 High-Level Functions 2.4 Low-Level Functions 3 Building a DECwindows Application 3.1 Accessing the User Interface 3.1.1 Initialization 3.1.2 Creating Widgets 3.1.3 Realizing the Top-Level Widget 3.1.4 Calling the Main Loop 3.2 Writing a Callback Function 3.2.1 Declaring Callback Functions 3.2.2 Accessing the Callback Argument List 3.2.2.1 Accessing the Widget ID 3.2.2.2 Accessing the User-Defined Data (Tag) 3.2.2.3 Accessing the Callback Structure Part II Reference to the DECwindows ToolKit DWT:ACTIVATE-WIDGET Convenience Routine DWT:ADD-ACTIONS Intrinsic Function DWT:ADD-CALLBACK Intrinsic Function DWT:ADD-CALLBACKS Intrinsic Function DWT:ADD-CONVERTER Intrinsic Function DWT:ADD-EVENT-HANDLER Intrinsic Function DWT:ADD-EXPOSURE-TO-REGION Intrinsic Func. DWT:ADD-FONT-LIST Compound String Function DWT:ADD-GRAB Intrinsic Function DWT:ADD-INPUT Intrinsic Function DWT:ADD-RAW-EVENT-HANDLER Intrinsic Function DWT:ADD-TIME-OUT Intrinsic Function DWT:ADD-WORK-PROC Intrinsic Function DWT:APP-ADD-ACTIONS Intrinsic Routine DWT:APP-ADD-CONVERTER Intrinsic Routine DWT:APP-ADD-INPUT Intrinsic Function DWT:APP-ADD-TIME-OUT Intrinsic Function DWT:APP-ADD-WORK-PROC Intrinsic Function DWT:APP-CREATE-SHELL Intrinsic Function DWT:APP-ERROR Intrinsic Routine DWT:APP-ERROR-MESSAGE Intrinsic Routine DWT:APP-GET-ERROR-DATABASE Intrinsic Routine DWT:APP-GET-ERROR-DATABASE-TEXT Intrinsic Routine DWT:APP-GET-SELECTION-TIMEOUT Intrinsic Routine DWT:APP-MAIN-LOOP Intrinsic Function DWT:APP-NEXT-EVENT Intrinsic Function DWT:APP-PEEK-EVENT Intrinsic Function DWT:APP-PENDING Intrinsic Function DWT:APP-PROCESS-EVENT Intrinsic Function DWT:APP-SET-ERROR-HANDLER Intrinsic Routine DWT:APP-SET-ERROR-MSG-HANDLER Intrinsic Routine DWT:APP-SET-SELECTION-TIMEOUT Intrinsic Routine DWT:APP-SET-WARNING-HANDLER Intrinsic Routine DWT:APP-SET-WARNING-MSG-HANDLER Intrinsic Routine DWT:APP-WARNING Intrinsic Routine DWT:APP-WARNING-MESSAGE Intrinsic Routine DWT:ATTACHED-DB High-Level Function DWT:ATTACHED-DB-CREATE Low-Level Function DWT:ATTACHED-DB-POPUP-CREATE Low-Level Function DWT:AUGMENT-TRANSLATIONS Intrinsic Function DWT:BEGIN-COPY-TO-CLIPBOARD Cut-and-Paste Function DWT:BUILD-EVENT-MASK Intrinsic Function DWT:CALL-ACCEPT-FOCUS Intrinsic Function DWT:CALL-CALLBACKS Intrinsic Function DWT:CALLBACK-EXCLUSIVE Intrinsic Function DWT:CALLBACK-NONE Intrinsic Function DWT:CALLBACK-NONEXCLUSIVE Convenience Function DWT:CALLBACK-POPDOWN Intrinsic Function DWT:CALLOC Intrinsic Function DWT:CANCEL-COPY-FORMAT Cut-and-Paste Function DWT:CANCEL-COPY-TO-CLIPBOARD Cut-and-Paste Function DWT:CAUTION-BOX High-Level Function DWT:CAUTION-BOX-CREATE Low-Level Function DWT:CHILDREN Convenience Function DWT:CLASS Intrinsic Function DWT:CLIPBOARD-LOCK Cut-and-Paste Function DWT:CLIPBOARD-REGISTER-FORMAT Cut-and-Paste Function DWT:CLIPBOARD-UNLOCK Cut-and-Paste Function DWT:CLOSE-DISPLAY Intrinsic Function DWT:CLOSE-HIERARCHY DRM Function DWT:COLOR-MIX-CREATE Low-Level Function DWT:COLOR-MIX-GET-NEW-COLOR High-Level Function DWT:COLOR-MIX-SET-NEW-COLOR High-Level Function DWT:COMMAND-APPEND High-Level Function DWT:COMMAND-ERROR-MESSAGE High-Level Function DWT:COMMAND-SET High-Level Function DWT:COMMAND-WINDOW High-Level Function DWT:COMMAND-WINDOW-CREATE Low-Level Function DWT:CONFIGURE-WIDGET Intrinsic Function DWT:CONVERT Intrinsic Function DWT:CONVERT-CASE Intrinsic Function DWT:COPY-FROM-CLIPBOARD Cut-and-Paste Function DWT:COPY-TO-CLIPBOARD Cut-and-Paste Function DWT:CREATE-APPLICATION-CONTEXT Intrinsic Function DWT:CREATE-APPLICATION-SHELL Intrinsic Function DWT:CREATE-FONT-LIST Compound String Function DWT:CREATE-MANAGED-WIDGET Intrinsic Function DWT:CREATE-POPUP-SHELL Intrinsic Function DWT:CREATE-WIDGET Intrinsic Function DWT:CREATE-WINDOW Intrinsic Function DWT:CSBYTECMP Compound String Function DWT:CSEMPTY Compound String Function DWT:CS-STRING Compound String Function DWT:CS-TEXT High-Level Function DWT:CS-TEXT-CLEAR-SELECTION High-Level Function DWT:CS-TEXT-CREATE Low-Level Function DWT:CS-TEXT-GET-EDITABLE High-Level Function DWT:CS-TEXT-GET-MAX-LENGTH High-Level Function DWT:CS-TEXT-GET-SELECTION High-Level Function DWT:CS-TEXT-GET-STRING High-Level Function DWT:CS-TEXT-REPLACE High-Level Function DWT:CS-TEXT-SET-EDITABLE High-Level Function DWT:CS-TEXT-SET-MAX-LENGTH High-Level Function DWT:CS-TEXT-SET-SELECTION High-Level Function DWT:CS-TEXT-SET-STRING High-Level Function DWT:CSTRCAT Compound String Function DWT:CSTRCPY Compound String Function DWT:CSTRLEN Compound String Function DWT:CSTRNCAT Compound String Function DWT:CSTRNCPY Compound String Function DWT:DATABASE Intrinsic Function DWT:DECWINDOWS Convenience Routine DWT:DESTROY-APPLICATION-CONTEXT Intrinsic Function DWT:DESTROY-GC Intrinsic Function DWT:DESTROY-WIDGET Intrinsic Function DWT:DIALOG-BOX High-Level Function DWT:DIALOG-BOX-CREATE Low-Level Function DWT:DIALOG-BOX-POPUP-CREATE Low-Level Function DWT:DIRECT-CONVERT Intrinsic Function DWT:DISOWN-SELECTION Intrinsic Function DWT:DISPATCH-EVENT Intrinsic Function DWT:DISPLAY Intrinsic Function DWT:DISPLAY-CS-MESSAGE Convenience Function DWT:DISPLAY-INITIALIZE Intrinsic Function DWT:DISPLAY-VMS-MESSAGE Convenience Function DWT:DRM-FREE-RESOURCE-CONTEXT DRM Function DWT:DRM-GET-RESOURCE-CONTEXT DRM Function DWT:DRM-HGET-INDEXED-LITERAL DRM Function DWT:DRM-RC-BUFFER DRM Function DWT:DRM-RC-SET-TYPE DRM Function DWT:DRM-RC-SIZE DRM Function DWT:DRM-RC-TYPE DRM Function DWT:DWTHELP High-Level Function DWT:DWTSTRING Compound String Function DWT:DWTWINDOW Intrinsic Function DWT:END-COPY-FROM-CLIPBOARD Cut-and-Paste Function DWT:END-COPY-TO-CLIPBOARD Cut-and-Paste Function DWT:ERROR-MSG Intrinsic Function DWT:FETCH-COLOR-LITERAL DRM Function DWT:FETCH-ICON-LITERAL High-Level Function DWT:FETCH-INTERFACE-MODULE DRM Function DWT:FETCH-SET-VALUES DRM Function DWT:FETCH-WIDGET DRM Function DWT:FETCH-WIDGET-OVERRIDE DRM Function DWT:FILE-SELECTION High-Level Function DWT:FILE-SELECTION-CREATE Low-Level Function DWT:FILE-SELECTION-DO-SEARCH High-Level Function DWT:FREE Intrinsic Function DWT:GET-APPLICATION-RESOURCES Intrinsic Function DWT:GET-DISPLAY Convenience Function DWT:GET-ERROR-DATABASE Intrinsic Function DWT:GET-ERROR-DATABASE-TEXT Intrinsic Function DWT:GET-GC Intrinsic Function DWT:GET-NEXT-SEGMENT Compound String Function DWT:GET-RESOURCE-LIST Intrinsic Function DWT:GET-SCREEN Convenience Function DWT:GET-SELECTION-TIMEOUT Intrinsic Function DWT:GET-SELECTION-VALUE Intrinsic Function DWT:GET-SELECTION-VALUE-INCR Intrinsic Function DWT:GET-SELECTION-VALUES Intrinsic Function DWT:GET-SELECTION-VALUES-INCR Intrinsic Function DWT:GET-SUBRESOURCES Intrinsic Function DWT:GET-SUBVALUES Intrinsic Function DWT:GET-USER-DATA Convenience Function DWT:GET-VALUES Intrinsic Function DWT:GET-WINDOW Convenience Function DWT:HAS-CALLBACKS Intrinsic Function DWT:HELP High-Level Function DWT:HELP-CREATE Low-Level Function DWT:INIT-GET-SEGMENT Compound String Function DWT:INITIALIZE Intrinsic Function DWT:INITIALIZE-DRM DRM Function DWT:INQUIRE-NEXT-PASTE-COUNT Cut-and-Paste Function DWT:INQUIRE-NEXT-PASTE-FORMAT Cut-and-Paste Function DWT:INQUIRE-NEXT-PASTE-LENGTH Cut-and-Paste Function DWT:INSTALL-ACCELERATORS Intrinsic Function DWT:INSTALL-ALL-ACCELERATORS Intrinsic Function DWT:IS-COMPOSITE Intrinsic Function DWT:IS-MANAGED Intrinsic Function DWT:IS-REALIZED Intrinsic Function DWT:IS-SENSITIVE Intrinsic Function DWT:IS-SUBCLASS Intrinsic Function DWT:LABEL High-Level Function DWT:LABEL-CREATE Low-Level Function DWT:LABEL-GADGET-CREATE Gadget Function DWT:LATIN1-STRING Compound String Function DWT:LIST-BOX High-Level Function DWT:LIST-BOX-ADD-ITEM High-Level Function DWT:LIST-BOX-CREATE Low-Level Function DWT:LIST-BOX-DELETE-ITEM High-Level Function DWT:LIST-BOX-DELETE-POS High-Level Function DWT:LIST-BOX-DESELECT-ALL-ITEMS High-Level Function DWT:LIST-BOX-DESELECT-ITEM High-Level Function DWT:LIST-BOX-DESELECT-POS High-Level Function DWT:LIST-BOX-ITEM-EXISTS High-Level Function DWT:LIST-BOX-SELECT-ITEM High-Level Function DWT:LIST-BOX-SELECT-POS High-Level Function DWT:LIST-BOX-SET-HORIZ-POS High-Level Function DWT:LIST-BOX-SET-ITEM High-Level Function DWT:LIST-BOX-SET-POS High-Level Function DWT:LIST-PENDING-ITEMS Cut-and-Paste Function DWT:MAIN-LOOP Intrinsic Function DWT:MAIN-SET-AREAS High-Level Function DWT:MAIN-WINDOW High-Level Function DWT:MAIN-WINDOW-CREATE Low-Level Function DWT:MAKE-GEOMETRY-REQUEST Intrinsic Function DWT:MAKE-RESIZE-REQUEST Intrinsic Function DWT:MALLOC Intrinsic Function DWT:MANAGE-CHILD Intrinsic Function DWT:MANAGE-CHILDREN Intrinsic Function DWT:MAP-WIDGET Intrinsic Function DWT:MENU High-Level Function DWT:MENU-BAR High-Level Function DWT:MENU-BAR-CREATE Low-Level Function DWT:MENU-CREATE Low-Level Function DWT:MENU-POPUP-CREATE Low-Level Function DWT:MENU-POSITION High-Level Function DWT:MENU-PULLDOWN-CREATE Low-Level Function DWT:MERGE-ARG-LISTS Intrinsic Function DWT:MESSAGE-BOX High-Level Function DWT:MESSAGE-BOX-CREATE Low-Level Function DWT:MOVE-WIDGET Intrinsic Function DWT:NAME-TO-WIDGET Intrinsic Function DWT:NEXT-EVENT Intrinsic Function DWT:NUMBER-CHILDREN Convenience Function DWT:OPEN-DISPLAY Intrinsic Function DWT:OPEN-HIERARCHY DRM Function DWT:OPTION-MENU High-Level Function DWT:OPTION-MENU-CREATE Low-Level Function DWT:OVERRIDE-TRANSLATIONS Intrinsic Function DWT:OWN-SELECTION Intrinsic Function DWT:OWN-SELECTION-INCREMENTAL Intrinsic Function DWT:PARENT Intrinsic Function DWT:PARSE-ACCELERATOR-TABLE Intrinsic Function DWT:PARSE-TRANSLATION-TABLE Intrinsic Function DWT:PEEK-EVENT Intrinsic Function DWT:PENDING Intrinsic Function DWT:POPDOWN Intrinsic Function DWT:POPUP Intrinsic Function DWT:PROCESS-EVENT Intrinsic Function DWT:PULL-DOWN-MENU-ENTRY High-Level Function DWT:PULL-DOWN-MENU-ENTRY-CREATE Low-Level Function DWT:PULL-DOWN-MENU-ENTRY-HILITE High-Level Function DWT:PUSH-BUTTON High-Level Function DWT:PUSH-BUTTON-CREATE Low-Level Function DWT:PUSH-BUTTON-GADGET-CREATE Gadget Function DWT:QUERY-GEOMETRY Intrinsic Function DWT:RADIO-BOX High-Level Function DWT:RADIO-BOX-CREATE Low-Level Function DWT:REALIZE-WIDGET Intrinsic Function DWT:REALLOC Intrinsic Function DWT:RECOPY-TO-CLIPBOARD Cut-and-Paste Function DWT:REGISTER-CASE-CONVERTER Intrinsic Function DWT:REGISTER-CLASS DRM Function DWT:REGISTER-DRM-NAMES DRM Function DWT:REMOVE-ALL-CALLBACKS Intrinsic Function DWT:REMOVE-CALLBACK Intrinsic Function DWT:REMOVE-CALLBACKS Intrinsic Function DWT:REMOVE-EVENT-HANDLER Intrinsic Function DWT:REMOVE-GRAB Intrinsic Function DWT:REMOVE-INPUT Intrinsic Function DWT:REMOVE-RAW-EVENT-HANDLER Intrinsic Function DWT:REMOVE-TIME-OUT Intrinsic Function DWT:REMOVE-WORK-PROC Intrinsic Function DWT:RESIZE-WIDGET Intrinsic Function DWT:RESIZE-WINDOW Intrinsic Function DWT:SCALE High-Level Function DWT:SCALE-CREATE Low-Level Function DWT:SCALE-GET-SLIDER High-Level Function DWT:SCALE-SET-SLIDER High-Level Function DWT:SCREEN Intrinsic Function DWT:SCROLL-BAR High-Level Function DWT:SCROLL-BAR-CREATE Low-Level Function DWT:SCROLL-BAR-GET-SLIDER High-Level Function DWT:SCROLL-BAR-SET-SLIDER High-Level Function DWT:SCROLL-WINDOW High-Level Function DWT:SCROLL-WINDOW-CREATE Low-Level Function DWT:SCROLL-WINDOW-SET-AREAS High-Level Function DWT:SELECTION High-Level Function DWT:SELECTION-CREATE Low-Level Function DWT:SEPARATOR High-Level Function DWT:SEPARATOR-CREATE Low-Level Function DWT:SEPARATOR-GADGET-CREATE Gadget Function DWT:SET-ERROR-HANDLER Intrinsic Function DWT:SET-ERROR-MSG-HANDLER Intrinsic Function DWT:SET-KEYBOARD-FOCUS Intrinsic Function DWT:SET-KEY-TRANSLATOR Intrinsic Function DWT:SET-MAPPED-WHEN-MANAGED Intrinsic Function DWT:SET-SELECTION-TIMEOUT Intrinsic Function DWT:SET-SENSITIVE Intrinsic Function DWT:SET-SUBVALUES Intrinsic Function DWT:SET-VALUES Intrinsic Function DWT:SET-WARNING-HANDLER Intrinsic Function DWT:SET-WARNING-MSG-HANDLER Intrinsic Function DWT:S-TEXT High-Level Function DWT:S-TEXT-CLEAR-SELECTION High-Level Function DWT:S-TEXT-CREATE Low-Level Function DWT:S-TEXT-GET-EDITABLE High-Level Function DWT:S-TEXT-GET-MAX-LENGTH High-Level Function DWT:S-TEXT-GET-SELECTION High-Level Function DWT:S-TEXT-GET-STRING High-Level Function DWT:S-TEXT-REPLACE High-Level Function DWT:S-TEXT-SET-EDITABLE High-Level Function DWT:S-TEXT-SET-MAX-LENGTH High-Level Function DWT:S-TEXT-SET-SELECTION High-Level Function DWT:S-TEXT-SET-STRING High-Level Function DWT:START-COPY-FROM-CLIPBOARD Cut-and-Paste-Function DWT:START-COPY-TO-CLIPBOARD High-Level Function DWT:STRING Compound String Function DWT:STRING-FREE-CONTEXT Compound String Function DWT:STRING-INIT-CONTEXT Compound String Function DWT:SUPERCLASS Intrinsic Function DWT:TOGGLE-BUTTON High-Level Function DWT:TOGGLE-BUTTON-CREATE Low-Level Function DWT:TOGGLE-BUTTON-GADGET-CREATE Gadget Function DWT:TOGGLE-BUTTON-GET-STATE High-Level Function DWT:TOGGLE-BUTTON-SET-STATE High-Level Function DWT:TOOLKIT-INITIALIZE Intrinsic Function DWT:TRANSLATE-COORDS Intrinsic Function DWT:TRANSLATE-KEYCODE Intrinsic Function DWT:UNDO-COPY-TO-CLIPBOARD Cut-and-Paste Function DWT:UNINSTALL-TRANSLATIONS Intrinsic Function DWT:UNMANAGE-CHILD Intrinsic Function DWT:UNMANAGE-CHILDREN Intrinsic Function DWT:UNREALIZE-WIDGET Intrinsic Function DWT:VMS-CLEAR-STRING Convenience Function DWT:VMS-FREE-ARGNAMES Convenience Function DWT:VMS-SET-ARG Convenience Function DWT:VMS-SET-CALLBACK-ARG Convenience Function DWT:VMS-SET-DESC-ARG Convenience Function DWT:WARNING Intrinsic Function DWT:WARNING-MSG Intrinsic Function DWT:WIDGET-TO-APPLICATION-CONTEXT Intrinsic Function DWT:WINDOW Intrinsic Function DWT:WINDOW-CREATE Low-Level Function DWT:WINDOW-TO-WIDGET Intrinsic Function DWT:WORK-BOX High-Level Function DWT:WORK-BOX-CREATE Low-Level Function DWT:XTERROR Intrinsic Function DWT:XTWARNING Intrinsic Function DWT:XTWINDOW Intrinsic Function Part III Guide to Programming CLX 4 Programming Overview of CLX 4.1 Overview of CLX 4.2 CLX Data Types 4.3 A Sample CLX Program 5 Managing the Client-Server Connection 5.1 Opening the Display 5.2 Getting Information About the Display and Screen 5.3 Sending Requests to the Server 5.4 Closing the Display 6 Working with Windows 6.1 Creating Windows 6.2 Destroying Windows 6.3 Mapping and Unmapping Windows 6.4 Associating Properties with Windows 6.4.1 Communicating with the Window Manager 6.4.2 Exchanging Properties Between Clients 6.5 Stacking Windows 6.6 Changing Window Attributes 7 Defining Graphics Characteristics 7.1 Creating a Graphics Context 7.2 Querying and Setting GContext Components 7.3 Copying and Freeing GContexts 7.4 Using GContexts Efficiently 8 Using Color 8.1 Pixels and Colormaps 8.2 Matching Color Requirements to Screen Types 8.3 Sharing Color Resources 8.3.1 Using Named Colors 8.3.2 Specifying Exact Color Values 8.4 Allocating Colors for Exclusive Use 8.4.1 Specifying a Colormap 8.4.2 Allocating Color Cells 8.5 Storing Color Values 8.6 Freeing Color Resources 8.7 Querying Colormap Entries 9 Graphics Functions 9.1 Drawing Points 9.2 Drawing Lines 9.3 Drawing and Filling Rectangles 9.4 Drawing and Filling Arcs 9.5 Clearing and Copying Areas 9.6 Creating Cursors 10 Using Pixmaps and Images 10.1 Creating and Freeing Pixmaps 10.2 Creating and Managing Bitmap Files 10.3 Working with Images 10.3.1 Creating Images 10.3.2 Getting Images from the Server 10.3.3 Sending Images to the Server 10.4 Freeing Images 11 Writing Text 11.1 Characters and Fonts 11.2 Specifying Fonts 11.3 Computing Text Size 11.4 Drawing Text on the Screen 12 Event Functions 12.1 Selecting Events 12.1.1 Constructing Event Masks 12.1.2 Specifying an Event Mask 12.1.3 Changing an Event Mask 12.2 Processing Events 12.2.1 Locking the Event Queue 12.2.2 Finding the Length of the Event Queue 12.2.3 Handling Events in the Queue 12.2.4 Adding an Event to the Queue 12.2.5 Removing an Event from the Queue 12.3 Controlling Events 12.3.1 Grabbing the Pointer 12.3.2 Grabbing the Keyboard 12.3.3 Grabbing the Server 12.3.4 Allowing Events 12.4 Sending Events 12.5 Event Keys 13 Window and Session Management 13.1 Reparenting Windows 13.2 Customizing the Keyboard and the Pointer 13.2.1 Ringing the Bell 13.2.2 Keyboard and Pointer Mappings 13.2.3 Keycode Mapping 13.2.4 Keyboard and Pointer Controls 13.2.5 Setting Pointer Controls 13.3 Using the Screen Saver 13.3.1 Querying the Screen Saver 13.3.2 Setting the Screen Saver 13.3.3 Enabling the Screen Saver 13.4 Controlling Network Access 13.4.1 Adding and Removing Hosts 13.4.2 Getting Information About Hosts 13.5 Closing the Connection 13.5.1 Deallocating Resources 13.5.2 Disconnecting Other Clients 13.5.3 Saving Windows 13.6 Finding Extensions Part IV Reference to Common LISP X CLX:ACCESS-CONTROL Function CLX:ACCESS-HOSTS Function CLX:ACTIVATE-SCREEN-SAVER Function CLX:ADD-ACCESS-HOST Function CLX:ADD-TO-SAVE-SET Function CLX:ALIST Type Specifier CLX:ALLOC-COLOR Function CLX:ALLOC-COLOR-CELLS Function CLX:ALLOC-COLOR-PLANES Function CLX:ALLOW-EVENTS Function CLX:ANGLE Type Specifier CLX:ARC-SEQ Type Specifier CLX:ARRAY-INDEX Type Specifier CLX:ATOM-NAME Function CLX:BELL Function CLX:BIT-GRAVITY Type Specifier CLX:BITMAP Type Specifier CLX:BITMAP-FORMAT Structure CLX:BITMAP-FORMAT-LSB-FIRST-P Function CLX:BITMAP-FORMAT-P Function CLX:BITMAP-FORMAT-PAD Function CLX:BITMAP-FORMAT-UNIT Function CLX:BOOLEAN Type Specifier CLX:CARD8 Type Specifier CLX:CARD16 Type Specifier CLX:CARD29 Type Specifier CLX:CHANGE-ACTIVE-POINTER-GRAB Function CLX:CHANGE-KEYBOARD-CONTROL Function CLX:CHANGE-KEYBOARD-MAPPING Function CLX:CHANGE-POINTER-CONTROL Function CLX:CHANGE-PROPERTY Function CLX:CHARACTER->KEYSYMS Function CLX:CHAR-ASCENT Function CLX:CHAR-ATTRIBUTES Function CLX:CHAR-DESCENT Function CLX:CHAR-LEFT-BEARING Function CLX:CHAR-RIGHT-BEARING Function CLX:CHAR-WIDTH Function CLX:CIRCULATE-WINDOW-DOWN Function CLX:CIRCULATE-WINDOW-UP Function CLX:CLEAR-AREA Function CLX:CLOSE-DISPLAY Function CLX:CLOSE-DOWN-MODE Function CLX:CLOSE-FONT Function CLX:COLOR Structure CLX:COLOR-BLUE Function CLX:COLOR-GREEN Function CLX:COLORMAP Structure CLX:COLORMAP-DISPLAY Function CLX:COLORMAP-EQUAL Function CLX:COLORMAP-ID Function CLX:COLORMAP-P Function CLX:COLOR-P Function CLX:COLOR-RED Function CLX:COLOR-RGB Function CLX:CONVERT-SELECTION Function CLX:COPY-AREA Function CLX:COPY-COLORMAP-AND-FREE Function CLX:COPY-GCONTEXT Function CLX:COPY-GCONTEXT-COMPONENTS Function CLX:COPY-IMAGE Function CLX:COPY-PLANE Function CLX:CREATE-COLORMAP Function CLX:CREATE-CURSOR Function CLX:CREATE-GCONTEXT Function CLX:CREATE-GLYPH-CURSOR Function CLX:CREATE-IMAGE Function CLX:CREATE-PIXMAP Function CLX:CREATE-WINDOW Function CLX:CURSOR-DISPLAY Function CLX:CURSOR-EQUAL Function CLX:CURSOR-ID Function CLX:CURSOR-P Function CLX:DELETE-PROPERTY Function CLX:DESTROY-SUBWINDOWS Function CLX:DESTROY-WINDOW Function CLX:DEVICE-EVENT-MASK Type Specifier CLX:DEVICE-EVENT-MASK-CLASS Type Specifier CLX:DISCARD-CURRENT-EVENT Function CLX:DISCARD-FONT-INFO Function CLX:DISPLAY Structure CLX:DISPLAY-AFTER-FUNCTION Function CLX:DISPLAY-BITMAP-FORMAT Function CLX:DISPLAY-DEFAULT-SCREEN Function CLX:DISPLAY-FINISH-OUTPUT Function CLX:DISPLAY-FORCE-OUTPUT Function CLX:DISPLAY-IMAGE-LSB-FIRST-P Function CLX:DISPLAY-MAX-KEYCODE Function CLX:DISPLAY-MAX-REQUEST-LENGTH Function CLX:DISPLAY-MIN-KEYCODE Function CLX:DISPLAY-MOTION-BUFFER-SIZE Function CLX:DISPLAY-P Function CLX:DISPLAY-PIXMAP-FORMATS Function CLX:DISPLAY-PROTOCOL-MAJOR-VERSION Function CLX:DISPLAY-PROTOCOL-MINOR-VERSION Function CLX:DISPLAY-RELEASE-NUMBER Function CLX:DISPLAY-ROOTS Function CLX:DISPLAY-VENDOR-NAME Function CLX:DRAWABLE Type Specifier CLX:DRAWABLE-BORDER-WIDTH Function CLX:DRAWABLE-DEPTH Function CLX:DRAWABLE-DISPLAY Function CLX:DRAWABLE-EQUAL Function CLX:DRAWABLE-HEIGHT Function CLX:DRAWABLE-ID Function CLX:DRAWABLE-P Function CLX:DRAWABLE-ROOT Function CLX:DRAWABLE-WIDTH Function CLX:DRAWABLE-X Function CLX:DRAWABLE-Y Function CLX:DRAW-ARC Function CLX:DRAW-ARCS Function CLX:DRAW-DIRECTION Type Specifier CLX:DRAW-GLYPH Function CLX:DRAW-GLYPHS Function CLX:DRAW-IMAGE-GLYPH Function CLX:DRAW-IMAGE-GLYPHS Function CLX:DRAW-LINE Function CLX:DRAW-LINES Function CLX:DRAW-POINT Function CLX:DRAW-POINTS Function CLX:DRAW-RECTANGLE Function CLX:DRAW-RECTANGLES Function CLX:DRAW-SEGMENTS Function CLX:EVENT-CASE Macro CLX:EVENT-KEY Type Specifier CLX:EVENT-LISTEN Function CLX:EVENT-MASK Type Specifier CLX:EVENT-MASK-CLASS Type Specifier CLX:FIND-ATOM Function CLX:FONT Structure CLX:FONTABLE Type Specifier CLX:FONT-ALL-CHARS-EXIST-P Function CLX:FONT-ASCENT Function CLX:FONT-DEFAULT-CHAR Function CLX:FONT-DESCENT Function CLX:FONT-DIRECTION Function CLX:FONT-DISPLAY Function CLX:FONT-EQUAL Function CLX:FONT-ID Function CLX:FONT-MAX-BYTE1 Function CLX:FONT-MAX-BYTE2 Function CLX:FONT-MAX-CHAR Function CLX:FONT-MIN-BYTE1 Function CLX:FONT-MIN-BYTE2 Function CLX:FONT-MIN-CHAR Function CLX:FONT-NAME Function CLX:FONT-P Function CLX:FONT-PATH Function CLX:FONT-PROPERTIES Function CLX:FONT-PROPERTY Function CLX:FONT-PROPS Type Specifier CLX:FORCE-GCONTEXT-CHANGES Function CLX:FREE-COLORMAP Function CLX:FREE-COLORS Function CLX:FREE-CURSOR Function CLX:FREE-GCONTEXT Function CLX:FREE-IMAGE Function CLX:FREE-PIXMAP Function CLX:GCONTEXT Structure CLX:GCONTEXT-ARC-MODE Function CLX:GCONTEXT-BACKGROUND Function CLX:GCONTEXT-CACHE-P Function CLX:GCONTEXT-CAP-STYLE Function CLX:GCONTEXT-CLIP-MASK Function CLX:GCONTEXT-CLIP-X Function CLX:GCONTEXT-CLIP-Y Function CLX:GCONTEXT-DASHES Function CLX:GCONTEXT-DASH-OFFSET Function CLX:GCONTEXT-DISPLAY Function CLX:GCONTEXT-EQUAL Function CLX:GCONTEXT-EXPOSURES Function CLX:GCONTEXT-FILL-RULE Function CLX:GCONTEXT-FILL-STYLE Function CLX:GCONTEXT-FONT Function CLX:GCONTEXT-FOREGROUND Function CLX:GCONTEXT-FUNCTION Function CLX:GCONTEXT-ID Function CLX:GCONTEXT-JOIN-STYLE Function CLX:GCONTEXT-KEY Type Specifier CLX:GCONTEXT-LINE-STYLE Function CLX:GCONTEXT-LINE-WIDTH Function CLX:GCONTEXT-P Function CLX:GCONTEXT-PLANE-MASK Function CLX:GCONTEXT-STIPPLE Function CLX:GCONTEXT-SUBWINDOW-MODE Function CLX:GCONTEXT-TILE Function CLX:GCONTEXT-TS-X Function CLX:GCONTEXT-TS-Y Function CLX:GET-IMAGE Function CLX:GET-PROPERTY Function CLX:GET-RAW-IMAGE Function CLX:GET-WM-CLASS Function CLX:GLOBAL-POINTER-POSITION Function CLX:GRAB-BUTTON Function CLX:GRAB-KEY Function CLX:GRAB-KEYBOARD Function CLX:GRAB-POINTER Function CLX:GRAB-SERVER Function CLX:GRAB-STATUS Type Specifier CLX:ICON-SIZES Function CLX:IMAGE Structure CLX:IMAGE-BIT-LSB-FIRST-P Function CLX:IMAGE-BITS-PER-PIXEL Function CLX:IMAGE-BLUE-MASK Function CLX:IMAGE-BYTE-LSB-FIRST-P Function CLX:IMAGE-BYTES-PER-LINE Function CLX:IMAGE-DEPTH Function CLX:IMAGE-DEPTH Type Specifier CLX:IMAGE-FORMAT Function CLX:IMAGE-GREEN-MASK Function CLX:IMAGE-HEIGHT Function CLX:IMAGE-P Function CLX:IMAGE-RED-MASK Function CLX:IMAGE-SCANLINE-PAD Function CLX:IMAGE-WIDTH Function CLX:IMAGE-XY-BITMAP-LIST Function CLX:IMAGE-Z-BITS-PER-PIXEL Function CLX:IMAGE-Z-PIXARRAY Function CLX:INDEX-SIZE Type Specifier CLX:INPUT-FOCUS Function CLX:INSTALL-COLORMAP Function CLX:INSTALLED-COLORMAPS Function CLX:INTERN-ATOM Function CLX:KEYBOARD-CONTROL Function CLX:KEYBOARD-MAPPING Function CLX:KEYCODE->CHARACTER Function CLX:KEYCODE->KEYSYM Function CLX:KEYSYM Type Specifier CLX:KEYSYM->CHARACTER Function CLX:KEYSYM->KEYCODES Function CLX:KILL-CLIENT Function CLX:KILL-TEMPORARY-CLIENTS Function CLX:LIST-EXTENSIONS Function CLX:LIST-FONT-NAMES Function CLX:LIST-FONTS Function CLX:LIST-PROPERTIES Function CLX:LOGICAL-OP Type Specifier CLX:LOOKUP-COLOR Function CLX:MAKE-COLOR Function CLX:MAKE-COLORMAP Function CLX:MAKE-CURSOR Function CLX:MAKE-DRAWABLE Function CLX:MAKE-EVENT-KEYS Function CLX:MAKE-EVENT-MASK Function CLX:MAKE-FONT Function CLX:MAKE-GCONTEXT Function CLX:MAKE-PIXMAP Function CLX:MAKE-STATE-KEYS Function CLX:MAKE-STATE-MASK Function CLX:MAKE-VISUAL-INFO Function CLX:MAKE-WINDOW Function CLX:MAP-SUBWINDOWS Function CLX:MAP-WINDOW Function CLX:MASK16 Type Specifier CLX:MASK32 Type Specifier CLX:MAX-CHAR-ASCENT Function CLX:MAX-CHAR-ATTRIBUTES Function CLX:MAX-CHAR-DESCENT Function CLX:MAX-CHAR-LEFT-BEARING Function CLX:MAX-CHAR-RIGHT-BEARING Function CLX:MAX-CHAR-WIDTH Function CLX:MIN-CHAR-ASCENT Function CLX:MIN-CHAR-ATTRIBUTES Function CLX:MIN-CHAR-DESCENT Function CLX:MIN-CHAR-LEFT-BEARING Function CLX:MIN-CHAR-RIGHT-BEARING Function CLX:MIN-CHAR-WIDTH Function CLX:MODIFIER-KEY Type Specifier CLX:MODIFIER-MAPPING Function CLX:MODIFIER-MASK Type Specifier CLX:MOTION-EVENTS Function CLX:OPEN-DISPLAY Function CLX:OPEN-FONT Function CLX:PIXARRAY Type Specifier CLX:PIXEL Type Specifier CLX:PIXMAP Structure CLX:PIXMAP-DISPLAY Function CLX:PIXMAP-EQUAL Function CLX:PIXMAP-FORMAT Structure CLX:PIXMAP-FORMAT-BITS-PER-PIXEL Function CLX:PIXMAP-FORMAT-DEPTH Function CLX:PIXMAP-FORMAT-P Function CLX:PIXMAP-FORMAT-PAD Function CLX:PIXMAP-ID Function CLX:PIXMAP-P Function CLX:POINTER-CONTROL Function CLX:POINTER-EVENT-MASK Type Specifier CLX:POINTER-EVENT-MASK-CLASS Type Specifier CLX:POINTER-MAPPING Function CLX:POINTER-POSITION Function CLX:POINT-SEQ Type Specifier CLX:PROCESS-EVENT Function CLX:PUT-IMAGE Function CLX:PUT-RAW-IMAGE Function CLX:QUERY-BEST-CURSOR Function CLX:QUERY-BEST-STIPPLE Function CLX:QUERY-BEST-TILE Function CLX:QUERY-COLORS Function CLX:QUERY-EXTENSION Function CLX:QUERY-KEYMAP Function CLX:QUERY-POINTER Function CLX:QUERY-TREE Function CLX:QUEUE-EVENT Function CLX:READ-BITMAP-FILE Function CLX:RECOLOR-CURSOR Function CLX:RECT-SEQ Type Specifier CLX:REMOVE-ACCESS-HOST Function CLX:REMOVE-FROM-SAVE-SET Function CLX:REPARENT-WINDOW Function CLX:REPEAT-SEQ Type Specifier CLX:RESET-SCREEN-SAVER Function CLX:RESOURCE-ID Type Specifier CLX:RGB-VAL Type Specifier CLX:SCREEN Structure CLX:SCREEN-BACKING-STORES Function CLX:SCREEN-BLACK-PIXEL Function CLX:SCREEN-DEFAULT-COLORMAP Function CLX:SCREEN-DEPTHS Function CLX:SCREEN-DISPLAY Function CLX:SCREEN-EVENT-MASK-AT-OPEN Function CLX:SCREEN-HEIGHT Function CLX:SCREEN-HEIGHT-IN-MILLIMETERS Function CLX:SCREEN-MAX-INSTALLED-MAPS Function CLX:SCREEN-MIN-INSTALLED-MAPS Function CLX:SCREEN-P Function CLX:SCREEN-ROOT Function CLX:SCREEN-ROOT-DEPTH Function CLX:SCREEN-ROOT-VISUAL Function CLX:SCREEN-SAVER Function CLX:SCREEN-SAVE-UNDERS-P Function CLX:SCREEN-WHITE-PIXEL Function CLX:SCREEN-WIDTH Function CLX:SCREEN-WIDTH-IN-MILLIMETERS Function CLX:SEG-SEQ Type Specifier CLX:SELECTION-OWNER Function CLX:SEND-EVENT Function CLX:SET-INPUT-FOCUS Function CLX:SET-MODIFIER-MAPPING Function CLX:SET-SCREEN-SAVER Function CLX:SET-WM-CLASS Function CLX:STATE-MASK-KEY Type Specifier CLX:STORE-COLOR Function CLX:STORE-COLORS Function CLX:STRINGABLE Type Specifier CLX:TEXT-EXTENTS Function CLX:TEXT-WIDTH Function CLX:TIMESTAMP Type Specifier CLX:TRANSLATE-COORDINATES Function CLX:TRANSLATE-DEFAULT Function CLX:UNGRAB-BUTTON Function CLX:UNGRAB-KEY Function CLX:UNGRAB-KEYBOARD Function CLX:UNGRAB-POINTER Function CLX:UNGRAB-SERVER Function CLX:UNINSTALL-COLORMAP Function CLX:UNMAP-SUBWINDOWS Function CLX:UNMAP-WINDOW Function CLX:VISUAL Type Specifier CLX:VISUAL-INFO Structure CLX:VISUAL-INFO-BITS-PER-RGB Function CLX:VISUAL-INFO-BLUE-MASK Function CLX:VISUAL-INFO-CLASS Function CLX:VISUAL-INFO-COLORMAP-ENTRIES Function CLX:VISUAL-INFO-GREEN-MASK Function CLX:VISUAL-INFO-ID Function CLX:VISUAL-INFO-P Function CLX:VISUAL-INFO-RED-MASK Function CLX:WARP-POINTER Function CLX:WARP-POINTER-IF-INSIDE Function CLX:WARP-POINTER-RELATIVE Function CLX:WARP-POINTER-RELATIVE-IF-INSIDE Function CLX:WINDOW Structure CLX:WINDOW-ALL-EVENT-MASKS Function CLX:WINDOW-BACKING-PIXEL Function CLX:WINDOW-BACKING-PLANES Function CLX:WINDOW-BACKING-STORE Function CLX:WINDOW-BIT-GRAVITY Function CLX:WINDOW-CLASS Function CLX:WINDOW-COLORMAP Function CLX:WINDOW-COLORMAP-INSTALLED-P Function CLX:WINDOW-DISPLAY Function CLX:WINDOW-DO-NOT-PROPAGATE-MASK Function CLX:WINDOW-EQUAL Function CLX:WINDOW-EVENT-MASK Function CLX:WINDOW-GRAVITY Function CLX:WINDOW-ID Function CLX:WINDOW-MAP-STATE Function CLX:WINDOW-OVERRIDE-REDIRECT Function CLX:WINDOW-P Function CLX:WINDOW-SAVE-UNDER Function CLX:WINDOW-VISUAL Function CLX:WIN-GRAVITY Type Specifier CLX:WITH-DISPLAY Macro CLX:WITH-EVENT-QUEUE Macro CLX:WITH-GCONTEXT Macro CLX:WITH-SERVER-GRABBED Macro CLX:WITH-STATE Macro CLX:WM-HINTS Function CLX:WM-HINTS Structure CLX:WM-HINTS-FLAGS Function CLX:WM-HINTS-ICON-MASK Function CLX:WM-HINTS-ICON-PIXMAP Function CLX:WM-HINTS-ICON-WINDOW Function CLX:WM-HINTS-ICON-X Function CLX:WM-HINTS-ICON-Y Function CLX:WM-HINTS-INITIAL-STATE Function CLX:WM-HINTS-INPUT Function CLX:WM-HINTS-P Function CLX:WM-HINTS-WINDOW-GROUP Function CLX:WM-ICON-NAME Function CLX:WM-NAME Function CLX:WM-NORMAL-HINTS Function CLX:WM-SIZE-HINTS Structure CLX:WM-SIZE-HINTS-HEIGHT Function CLX:WM-SIZE-HINTS-HEIGHT-INC Function CLX:WM-SIZE-HINTS-MAX-ASPECT Function CLX:WM-SIZE-HINTS-MAX-HEIGHT Function CLX:WM-SIZE-HINTS-MAX-WIDTH Function CLX:WM-SIZE-HINTS-MIN-ASPECT Function CLX:WM-SIZE-HINTS-MIN-HEIGHT Function CLX:WM-SIZE-HINTS-MIN-WIDTH Function CLX:WM-SIZE-HINTS-P Function CLX:WM-SIZE-HINTS-USER-SPECIFIED-POSITION-P Function CLX:WM-SIZE-HINTS-USER-SPECIFIED-SIZE-P Function CLX:WM-SIZE-HINTS-WIDTH Function CLX:WM-SIZE-HINTS-WIDTH-INC Function CLX:WM-SIZE-HINTS-X Function CLX:WM-SIZE-HINTS-Y Function CLX:WM-ZOOM-HINTS Function CLX:WRITE-BITMAP-FILE Function CLX:XATOM Type Specifier A DECwindows Constants B CLX to X11 Mappings EXAMPLES 2-1 Defining the UIL Module 2-2 Defining the Main Window 2-3 Defining a Simple Text Widget 2-4 Defining a Menu Bar 2-5 Defining Pull-Down Menu Entries 2-6 Defining Widget Variables 2-7 Defining Widgets with High-Level Functions 2-8 Creating a Message Box 3-1 Initializing a UIL Application 3-2 Creating a Widget Hierarchy 3-3 Realizing the User Interface 3-4 Calling the Main Loop 3-5 Creating a List of Callback Names 3-6 Creating a List of Callback Entry Points 3-7 Accessing the Callback Widget 3-8 Writing to a Text Widget 3-9 Pretty-Printing a Recipe 3-10 Accessing Callback Arguments 3-11 Printing Calorie Information 4-1 Sample CLX Program 6-1 Creating a Window 6-2 Changing Window Attributes 9-1 Drawing Points 9-2 Drawing Lines and Line Segments 9-3 Drawing an Arc 9-4 Creating a Cursor 10-1 Modifying Image Data 11-1 Specifying Fonts 11-2 Drawing Text 12-1 Using the CLX:PROCESS-EVENT Function 12-2 Using the CLX:EVENT-CASE Macro FIGURES 1-1 DECwindows Layered Architecture 1-2 Hello World! Application 1-3 Hello World! Widget Hierarchy 2-1 Choosing from a Pull-Down Menu 2-2 A Widget Hierarchy 2-3 A Message Box 3-1 DECwindows Callback Argument List 9-1 Drawing Points 9-2 Drawing Lines and Line Segments 9-3 Drawing an Arc 10-1 Displaying an Image 11-1 Drawing Text 12-1 The Event Queue TABLES 1-1 Types of DECwindows Widgets 4-1 CLX Data Types 5-1 Information Functions for DISPLAY Objects 5-2 Information Functions for CLX:SCREEN Objects 5-3 Output Buffer Routines 6-1 CLX:CREATE-WINDOW Keywords 6-2 Information Functions for CLX:WM-HINTS Objects 6-3 Information Functions for CLX:WM-SIZE-HINTS Objects 6-4 Additional Window Manager Property Functions 6-5 Information Functions for CLX:WINDOW Objects 6-6 SETF Functions for CLX:WINDOW Objects 6-7 Information Functions for CLX:DRAWABLE Objects 7-1 CLX:CREATE-GCONTEXT Keywords 7-2 CLX:LOGICAL-OP Values 7-3 Information Functions for CLX:GCONTEXT Objects 8-1 Information Functions for CLX:VISUAL-INFO Objects 8-2 Information Functions for CLX:COLOR Objects 8-3 Information Functions for CLX:COLORMAP Objects 10-1 Information Functions for Pixmaps 10-2 Information Functions for Pixmap Formats 10-3 Information Functions for Bitmap-Formats 10-4 Information Functions for CLX:IMAGE Objects 10-5 Information Functions for :XY-PIXMAP Images 10-6 Information Functions for :Z-PIXMAP Images 11-1 Information Functions for Characters 11-2 Information Functions for CLX:FONT Objects 12-1 Event Keys 12-2 Event Masks 12-3 Pointer Event Masks 12-4 State Masks 12-5 Modifier Masks 12-6 :BUTTON-PRESS Event-Key 12-7 :BUTTON-RELEASE Event-Key 12-8 :CIRCULATE-NOTIFY Event-Key 12-9 :CIRCULATE-REQUEST Event-Key 12-10 :CLIENT-MESSAGE Event-Key 12-11 :COLORMAP-NOTIFY Event-Key 12-12 :CONFIGURE-NOTIFY Event-Key 12-13 :CONFIGURE-REQUEST Event-Key 12-14 :CREATE-NOTIFY Event-Key 12-15 :DESTROY-NOTIFY Event-Key 12-16 :ENTER-NOTIFY Event-Key 12-17 :EXPOSURE Event-Key 12-18 :FOCUS-IN Event-Key 12-19 :FOCUS-OUT Event-Key 12-20 :GRAPHICS-EXPOSURE Event-Key 12-21 :GRAVITY-NOTIFY Event-Key 12-22 :KEYMAP-NOTIFY Event-Key 12-23 :KEY-PRESS Event-Key 12-24 :KEY-RELEASE Event-Key 12-25 :LEAVE-NOTIFY Event-Key 12-26 :MAPPING-NOTIFY Event-Key 12-27 :MAP-NOTIFY Event-Key 12-28 :MAP-REQUEST Event-Key 12-29 :MOTION-NOTIFY Event-Key 12-30 :NO-EXPOSURE Event-Key 12-31 :PROPERTY-NOTIFY Event-Key 12-32 :REPARENT-NOTIFY Event-Key 12-33 :RESIZE-REQUEST Event-Key 12-34 :SELECTION-CLEAR Event-Key 12-35 :SELECTION-NOTIFY Event-Key 12-36 :SELECTION-REQUEST Event-Key 12-37 :UNMAP-NOTIFY Event-Key 12-38 :VISIBILITY-NOTIFY Event-Key CLX-1 WITH-STATE Accessor and SETF Groups A-1 DECwindows Constants Defined by VAX LISP A-2 DRM Constants A-3 Callback Reasons B-1 Mapping X11 Requests to CLX Functions B-2 Mapping CLX Functions and Macros to X11 Requests