Motif 2.1 Programmer's Guide

<BODY BGCOLOR="FCFBF0"> <CENTER> <FONT COLOR="#A62A2A" SIZE="+2"> </FONT> </CENTER> <HR> <H1><a href="edition.htm#A3D60C85534slsb">First Edition (October 1997)</a></H1> <H1><a href="trademar.htm">Trademarks</a></H1> <H1><a href="about.htm#HDRWQ3">Preface</a></H1> <H1><a href="motifpg7.htm#HDRWQ20">Chapter 1. Introduction</a></H1> <H2><a href="motifpg8.htm#HDRWQ21">The X Window System</a></H2> <H2><a href="motifpg9.htm#HDRWQ22">Xlib, Xt, and Motif</a></H2> <H2><a href="motifph6.htm#HDRWQ36">Widget Classes and Hierarchy</a></H2> <H2><a href="motifpi6.htm#HDRWQ43">Header Files and Libraries</a></H2> <H1><a href="motifpj6.htm#HDRWQ44">Chapter 2. The Motif Programming Model</a></H1> <H2><a href="motifpk6.htm#HDRWQ45">A User-Centered Model</a></H2> <H2><a href="motifpl6.htm#HDRWQ46">Separating Interface from Application</a></H2> <H2><a href="motifpm6.htm#HDRWQ47">Building Blocks: Primitive Widgets and Gadgets</a></H2> <H2><a href="motifpn6.htm#HDRWQ53">Managers</a></H2> <H2><a href="motifph7.htm#HDRWQ65">Shells</a></H2> <H2><a href="motifpi7.htm#HDRWQ69">Applications, Top-Level Widgets, and Dialogs</a></H2> <H2><a href="motifpj7.htm#HDRWQ73">Resources: User and Program Customization</a></H2> <H2><a href="motifpk7.htm#HDRWQ74">Handling Input and Output</a></H2> <H1><a href="motifpl7.htm#HDRWQ75">Chapter 3. Structure of a Motif Program</a></H1> <H2><a href="motifpm7.htm#HDRWQ84">Including Header Files</a></H2> <H2><a href="motifpn7.htm#HDRWQ85">Initializing the Intrinsics</a></H2> <H2><a href="motifpo7.htm#HDRWQ95">Creating Widgets</a></H2> <H2><a href="motifpp7.htm#HDRWQ116">Adding Callback Procedures</a></H2> <H2><a href="motifpq7.htm#HDRWQ117">Making Widgets Visible</a></H2> <H2><a href="motifph8.htm#HDRWQ122">Entering the Event Loop</a></H2> <H2><a href="motifpi8.htm#HDRWQ123">Writing Threaded Applications</a></H2> <H1><a href="motifpj8.htm#HDRWQ132">Chapter 4. Structure of a Program Using UIL and MRM</a></H1> <H2><a href="motifpk8.htm#HDRWQ133">Structure of a UIL Module</a></H2> <H2><a href="motifpl8.htm#HDRWQ147">Structure of a Program Using MRM</a></H2> <H1><a href="motifpm8.htm#HDRWQ158">Chapter 5. Basic Controls</a></H1> <H2><a href="motifpn8.htm#HDRWQ159">Core, RectObj, XmPrimitive, and XmGadget Classes</a></H2> <H2><a href="motifpo8.htm#HDRWQ164">Labels, Buttons, and Separators</a></H2> <H2><a href="motifpp8.htm#HDRWQ173">ScrollBar</a></H2> <H2><a href="motifpq8.htm#HDRWQ174">Scale</a></H2> <H2><a href="motifph9.htm#HDRWQ179">List</a></H2> <H2><a href="motifpi9.htm#HDRWQ185">Text and TextField</a></H2> <H1><a href="motifpj9.htm#HDRWQ186">Chapter 6. Menus and Options</a></H1> <H2><a href="motifpk9.htm#HDRWQ187">Menu Components: Buttons, RowColumn, MenuShell</a></H2> <H2><a href="motifpl9.htm#HDRWQ191">MenuBar</a></H2> <H2><a href="motifpm9.htm#HDRWQ192">PopupMenu</a></H2> <H2><a href="motifpn9.htm#HDRWQ193">PulldownMenu</a></H2> <H2><a href="motifpo9.htm#HDRWQ194">OptionMenu</a></H2> <H2><a href="motifpp9.htm#HDRWQ195">RadioBox and CheckBox</a></H2> <H2><a href="motifpq9.htm#HDRWQ196">TearOffMenus</a></H2> <H2><a href="motifph0.htm#HDRWQ197">ComboBox</a></H2> <H2><a href="motifpi0.htm#HDRWQ207">SpinBox</a></H2> <H2><a href="motifpj0.htm#HDRWQ213">SimpleSpinBox</a></H2> <H1><a href="motifpk0.htm#HDRWQ214">Chapter 7. Dialogs</a></H1> <H2><a href="motifpl0.htm#HDRWQ215">BulletinBoard and DialogShell</a></H2> <H2><a href="motifpm0.htm#HDRWQ220">Making a Selection: SelectionBox</a></H2> <H2><a href="motifpn0.htm#HDRWQ221">Choosing a Pathname: FileSelectionBox</a></H2> <H2><a href="motifpo0.htm#HDRWQ222">Command</a></H2> <H2><a href="motifpp0.htm#HDRWQ223">MessageBox</a></H2> <H2><a href="motifpq0.htm#HDRWQ232">Form</a></H2> <H1><a href="motifph1.htm#HDRWQ233">Chapter 8. Scrolling, Panes, Frames, Containers, and Notebooks</a></H1> <H2><a href="motifpi1.htm#HDRWQ234">ScrolledWindow</a></H2> <H2><a href="motifpj1.htm#HDRWQ237">Automatic Scrolling</a></H2> <H2><a href="motifpk1.htm#HDRWQ240">Application-Defined Scrolling</a></H2> <H2><a href="motifpl1.htm#HDRWQ242">MainWindow</a></H2> <H2><a href="motifpm1.htm#HDRWQ243">Container</a></H2> <H2><a href="motifpn1.htm#HDRWQ244">Notebook</a></H2> <H2><a href="motifpo1.htm#HDRWQ245">Frame</a></H2> <H2><a href="motifpp1.htm#HDRWQ246">PanedWindow</a></H2> <H1><a href="motifpq1.htm#HDRWQ247">Chapter 9. Compound Strings</a></H1> <H2><a href="motifph2.htm#HDRWQ248">The Structure of a Compound String</a></H2> <H2><a href="motifpi2.htm#HDRWQ256">Renditions</a></H2> <H2><a href="motifpj2.htm#HDRWQ266">Horizontal Tabs</a></H2> <H2><a href="motifpk2.htm#HDRWQ270">Parse Tables</a></H2> <H2><a href="motifpl2.htm#HDRWQ274">Compound Strings in UIL</a></H2> <H1><a href="motifpm2.htm#HDRWQ278">Chapter 10. Text</a></H1> <H2><a href="motifpn2.htm#HDRWQ279">Text and TextField</a></H2> <H2><a href="motifpo2.htm#HDRWQ288">Data Transfer in Text</a></H2> <H2><a href="motifpp2.htm#HDRWQ291">Text Editing and Callbacks</a></H2> <H2><a href="motifpq2.htm#HDRWQ292">Text Resources and Geometry</a></H2> <H2><a href="motifph3.htm#HDRWQ293">Convenience Routines</a></H2> <H2><a href="motifpi3.htm#HDRWQ294">ScrolledText</a></H2> <H2><a href="motifpj3.htm#HDRWQ295">Storing Text in a File</a></H2> <H2><a href="motifpk3.htm#HDRWQ296">Sharing Text Sources</a></H2> <H1><a href="motifpl3.htm#HDRWQ297">Chapter 11. Internationalization</a></H1> <H2><a href="motifpm3.htm#HDRWQ298">Issues in Internationalized Applications</a></H2> <H2><a href="motifpn3.htm#HDRWQ317">Localizing Applications</a></H2> <H2><a href="motifpo3.htm#HDRWQ332">Layout Direction</a></H2> <H2><a href="motifpp3.htm#HDRWQ336">Internationalization and Text Input</a></H2> <H2><a href="motifpq3.htm#HDRWQ360">Compound Strings and Compound Text</a></H2> <H1><a href="motifph4.htm#HDRWQ362">Chapter 12. Color and Pixmaps</a></H1> <H2><a href="motifpi4.htm#HDRWQ363">Default Colors and Pixmaps</a></H2> <H2><a href="motifpj4.htm#HDRWQ390">Application-Defined Color Generation</a></H2> <H2><a href="motifpk4.htm#HDRWQ391">Colormaps</a></H2> <H2><a href="motifpl4.htm#HDRWQ392">Using Pixmaps</a></H2> <H1><a href="motifpm4.htm#HDRWQ393">Chapter 13. Input, Focus, and Keyboard Navigation</a></H1> <H2><a href="motifpn4.htm#HDRWQ394">Focus Models</a></H2> <H2><a href="motifpo4.htm#HDRWQ395">Controlling Keyboard Navigation</a></H2> <H2><a href="motifpp4.htm#HDRWQ454">Translations and Actions</a></H2> <H2><a href="motifpq4.htm#HDRWQ459">Mnemonics and Accelerators</a></H2> <H2><a href="motifpo6.htm#HDRWQ460">Event Handlers</a></H2> <H2><a href="motifpp6.htm#HDRWQ461">Guidelines for Grabs</a></H2> <H1><a href="motifpq6.htm#HDRWQ462">Chapter 14. Managing Geometry</a></H1> <H2><a href="motifpr6.htm#HDRWQ463">Shells and Their Children</a></H2> <H2><a href="motifps6.htm#HDRWQ464">Manager Widgets and Their Children</a></H2> <H2><a href="motifpt6.htm#HDRWQ465">Managing Geometry Using RowColumn</a></H2> <H2><a href="motifpu6.htm#HDRWQ466">Managing Geometry Using BulletinBoard and DrawingArea</a></H2> <H2><a href="motifpv6.htm#HDRWQ467">Managing Geometry Using Form</a></H2> <H1><a href="motifpw6.htm#HDRWQ468">Chapter 15. Graphics and Text in a DrawingArea</a></H1> <H2><a href="motifpx6.htm#HDRWQ469">DrawingArea: A General-Purpose Widget</a></H2> <H2><a href="motifpy6.htm#HDRWQ470">Event Handling and Callbacks</a></H2> <H2><a href="motifpz6.htm#HDRWQ479">Using a DrawingArea in a ScrolledWindow</a></H2> <H2><a href="motifpa6.htm#HDRWQ480">Using a DrawingArea for Graphics</a></H2> <H2><a href="motifpb6.htm#HDRWQ481">DrawingArea and Advanced Text Editing</a></H2> <H1><a href="motifpc6.htm#HDRWQ484">Chapter 16. Data Transfer with UTM</a></H1> <H2><a href="motifpd6.htm#HDRWQ485">What is UTM?</a></H2> <H2><a href="motifpe6.htm#HDRWQ486">Why Use UTM?</a></H2> <H2><a href="motifpf6.htm#HDRWQ487">Ideas For Applications</a></H2> <H2><a href="motifqp6.htm#HDRWQ488">Implementation Overview</a></H2> <H2><a href="motifrp6.htm#HDRWQ492">Case Study: Adding an Extra Target to XmText</a></H2> <H1><a href="motifsp6.htm#HDRWQ496">Chapter 17. Drag and Drop</a></H1> <H2><a href="motiftp6.htm#HDRWQ497">User Overview of Drag and Drop</a></H2> <H2><a href="motifup6.htm#HDRWQ505">Application Programmer's Overview of Drag and Drop</a></H2> <H2><a href="motifvp6.htm#HDRWQ518">Drag and Drop Protocols</a></H2> <H2><a href="motifwp6.htm#HDRWQ534">Drop Receiver Responsibilities for Dragging</a></H2> <H2><a href="motifxp6.htm#HDRWQ547">Drag Initiator Responsibilities for Dragging</a></H2> <H2><a href="motifyp6.htm#HDRWQ568">Drop Receiver Responsibilities for Dropping</a></H2> <H2><a href="motifzp6.htm#HDRWQ571">Drag Initiator Responsibilities for Dropping</a></H2> <H1><a href="motifap6.htm#HDRWQ576">Chapter 18. MWM and the ICCCM</a></H1> <H2><a href="motifbp6.htm#HDRWQ577">Window Managers, ICCCM, and Shells</a></H2> <H2><a href="motifcp6.htm#HDRWQ591">MWM Properties and Resources</a></H2> <H2><a href="motifdp6.htm#HDRWQ598">Atom and Protocol Management</a></H2> <H1><a href="motifep6.htm#HDRWQ599">Chapter 19. Printing</a></H1> <H2><a href="motiffp6.htm#HDRWQ600">The Printing APIs</a></H2> <H2><a href="motifgp6.htm#HDRWQ601">Motif Widget Printing</a></H2> <H1><a href="motifhp6.htm#HDRWQ605">Appendix A. The Motif Clipboard</a></H1> <H2><a href="motifip6.htm#HDRWQ606">Copying Data to the Clipboard</a></H2> <H2><a href="motifjp6.htm#HDRWQ607">Retrieving Data from the Clipboard</a></H2> <H2><a href="motifkp6.htm#HDRWQ608">Utility Routines</a></H2> <H1><a href="motiflp6.htm#HDRWQ609">Appendix B. Data Transfer in the Motif Toolkit</a></H1> <H1><a href="motifmp6.htm#Header_429">Appendix C. Glossary</a></H1>