Motif 2.1 Widget Writer's Guide

<BODY BGCOLOR="FCFBF0"> <CENTER> <FONT COLOR="#A62A2A" SIZE="+2"> </FONT> </CENTER> <HR> <H1><a href="edition.htm#A3D60C85534slsc">First Edition (October 1997)</a></H1> <H1><a href="trademar.htm">Trademarks</a></H1> <H1><a href="about.htm#HDRWQ4">Preface</a></H1> <H1><a href="motifwg7.htm#HDRWQ24">Chapter 1. What Is Involved in Writing a Motif Widget</a></H1> <H2><a href="motifwg8.htm#HDRWQ25">Pros and Cons of Writing a Motif Widget</a></H2> <H2><a href="motifwg9.htm#HDRWQ26">Prerequisite Knowledge</a></H2> <H2><a href="motifwh6.htm#HDRWQ27">The Software You Will Need</a></H2> <H2><a href="motifwi6.htm#HDRWQ29">What Kinds of Widgets Can You Create?</a></H2> <H2><a href="motifwj6.htm#HDRWQ30">How Much Work Is Involved?</a></H2> <H2><a href="motifwk6.htm#HDRWQ31">Defining the Goal</a></H2> <H1><a href="motifwl6.htm#HDRWQ32">Chapter 2. A Motif Widget Writing Tutorial</a></H1> <H2><a href="motifwm6.htm#HDRWQ33">Namespace</a></H2> <H2><a href="motifwh7.htm#HDRWQ34">Recommended Files for Each Widget</a></H2> <H2><a href="motifwi7.htm#HDRWQ35">The Widget Public Header File</a></H2> <H2><a href="motifwj7.htm#HDRWQ42">The Widget Private Header File</a></H2> <H2><a href="motifwk7.htm#HDRWQ56">The Widget Source Code File</a></H2> <H2><a href="motifwl7.htm#HDRWQ98">Make the Widget Accessible to Applications</a></H2> <H2><a href="motifwm7.htm#HDRWQ99">MultiThread-Safe Motif Widgets</a></H2> <H1><a href="motifwn7.htm#HDRWQ129">Chapter 3. The Widget Class Record of Primitive Widgets</a></H1> <H2><a href="motifwo7.htm#HDRWQ131">The CoreClassPart Structure</a></H2> <H2><a href="motifwp7.htm#HDRWQ164">The PrimitiveClassPart Structure</a></H2> <H2><a href="motifwq7.htm#HDRWQ172">The Primitive Class Extension Record</a></H2> <H2><a href="motifwh8.htm#HDRWQ180">The Instance Data Members of XmPrimitive</a></H2> <H1><a href="motifwi8.htm#HDRWQ186">Chapter 4. The Widget Class Record of Manager Widgets</a></H1> <H2><a href="motifwj8.htm#HDRWQ188">The CoreClassPart Structure</a></H2> <H2><a href="motifwk8.htm#HDRWQ221">The CompositeClassPart Structure</a></H2> <H2><a href="motifwl8.htm#HDRWQ227">The ConstraintClassPart Structure</a></H2> <H2><a href="motifwm8.htm#HDRWQ235">The ManagerClassPart Structure</a></H2> <H2><a href="motifwn8.htm#HDRWQ244">The Manager Class Extension Record</a></H2> <H2><a href="motifwo8.htm#HDRWQ251">The Instance Data Members of XmManager</a></H2> <H1><a href="motifwp8.htm#HDRWQ266">Chapter 5. Traits</a></H1> <H2><a href="motifwq8.htm#HDRWQ267">What Is a Trait?</a></H2> <H2><a href="motifwh9.htm#HDRWQ283">Why Use Traits?</a></H2> <H2><a href="motifwi9.htm#HDRWQ284">Installing a Trait</a></H2> <H2><a href="motifwj9.htm#HDRWQ289">Accessing Traits</a></H2> <H2><a href="motifwk9.htm#HDRWQ292">Overriding a Trait Record Variable</a></H2> <H1><a href="motifwl9.htm#HDRWQ293">Chapter 6. Resources</a></H1> <H2><a href="motifwm9.htm#HDRWQ294">Defining Motif Resources</a></H2> <H2><a href="motifwn9.htm#HDRWQ297">Synthetic Resources</a></H2> <H2><a href="motifwo9.htm#HDRWQ305">Representation Types</a></H2> <H2><a href="motifwp9.htm#HDRWQ306">Enumerated Representation Types</a></H2> <H2><a href="motifwq9.htm#HDRWQ310">Nonenumerated Representation Types</a></H2> <H2><a href="motifwh0.htm#HDRWQ327">Motif Representation Types in XmPrimitive and XmManager</a></H2> <H1><a href="motifwi0.htm#HDRWQ372">Chapter 7. Translations and Actions</a></H1> <H2><a href="motifwj0.htm#HDRWQ373">Defining Translations in the Class Record</a></H2> <H2><a href="motifwk0.htm#HDRWQ374">Conflicts Between tm_table and translations</a></H2> <H2><a href="motifwl0.htm#HDRWQ375">Virtual Keysyms</a></H2> <H2><a href="motifwm0.htm#HDRWQ411">Enter Actions</a></H2> <H2><a href="motifwn0.htm#HDRWQ412">Leave Actions</a></H2> <H2><a href="motifwo0.htm#HDRWQ413">Mouse Bindings</a></H2> <H2><a href="motifwp0.htm#HDRWQ418">Keyboard Traversal</a></H2> <H1><a href="motifwq0.htm#HDRWQ419">Chapter 8. Using Xme Functions Within a Widget</a></H1> <H2><a href="motifwh1.htm#HDRWQ420">Calling an Xme function</a></H2> <H2><a href="motifwi1.htm#HDRWQ421">Xme Trait Functions</a></H2> <H2><a href="motifwj1.htm#HDRWQ425">Rendering Geometric Objects</a></H2> <H2><a href="motifwk1.htm#HDRWQ436">Xme Resolution Independence Functions</a></H2> <H2><a href="motifwl1.htm#HDRWQ442">Xme String Functions</a></H2> <H2><a href="motifwm1.htm#HDRWQ450">Implementing Data Transfer</a></H2> <H2><a href="motifwn1.htm#HDRWQ469">Xme Geometry Functions</a></H2> <H2><a href="motifwo1.htm#HDRWQ474">Xme Focus/Traversal Functions</a></H2> <H2><a href="motifwp1.htm#HDRWQ479">Xme Miscellaneous Functions</a></H2> <H1><a href="motifwq1.htm#HDRWQ492">Chapter 9. Handling Textual Data</a></H1> <H2><a href="motifwh2.htm#HDRWQ493">Text Versus Compound Strings</a></H2> <H2><a href="motifwi2.htm#HDRWQ494">Editable Versus Noneditable Text</a></H2> <H2><a href="motifwj2.htm#HDRWQ495">Recommended Resources for Compound String Widgets</a></H2> <H2><a href="motifwk2.htm#HDRWQ500">Rendering the Compound String</a></H2> <H2><a href="motifwl2.htm#HDRWQ501">The XmQTaccessTextual Trait</a></H2> <H1><a href="motifwm2.htm#HDRWQ519">Chapter 10. Data Transfer Between Widgets with UTM</a></H1> <H2><a href="motifwn2.htm#HDRWQ520">A Data Transfer Tutorial</a></H2> <H2><a href="motifwo2.htm#HDRWQ546">Overview of Implementing UTM</a></H2> <H2><a href="motifwp2.htm#HDRWQ568">UTM and the Application</a></H2> <H2><a href="motifwq2.htm#HDRWQ572">Primary Transfer Details</a></H2> <H2><a href="motifwh3.htm#HDRWQ577">Clipboard Transfer Details</a></H2> <H2><a href="motifwi3.htm#HDRWQ586">Drag and Drop Transfer Details</a></H2> <H2><a href="motifwj3.htm#HDRWQ592">Writing a Conversion Routine</a></H2> <H2><a href="motifwk3.htm#HDRWQ599">Writing a Destination Routine</a></H2> <H2><a href="motifwl3.htm#HDRWQ600">Writing a Transfer Procedure</a></H2> <H2><a href="motifwm3.htm#HDRWQ602">Timestamps</a></H2> <H2><a href="motifwn3.htm#HDRWQ603">Transferring Multiple Targets</a></H2> <H1><a href="motifwo3.htm#HDRWQ604">Chapter 11. How to Write a Motif Button Widget</a></H1> <H2><a href="motifwp3.htm#HDRWQ605">Buttons to Write and Buttons to Avoid Writing</a></H2> <H2><a href="motifwq3.htm#HDRWQ606">Writing Your Own DialogBox Button</a></H2> <H2><a href="motifwh4.htm#HDRWQ612">Writing Your Own Menu Button Widget</a></H2> <H2><a href="motifwi4.htm#HDRWQ621">Writing Your Own Tab Button</a></H2> <H1><a href="motifwj4.htm#HDRWQ622">Chapter 12. Geometry Management</a></H1> <H2><a href="motifwk4.htm#HDRWQ623">Overview</a></H2> <H2><a href="motifwl4.htm#HDRWQ630">The Parent's changed_managed Method</a></H2> <H2><a href="motifwm4.htm#HDRWQ631">The Parent's geometry_manager Method</a></H2> <H2><a href="motifwn4.htm#HDRWQ632">The initialize Method</a></H2> <H2><a href="motifwo4.htm#HDRWQ635">The Child's set_values and set_values_almost Method</a></H2> <H2><a href="motifwp4.htm#HDRWQ636">The Child's resize Method</a></H2> <H2><a href="motifwq4.htm#HDRWQ638">The child's query_geometry Method</a></H2> <H2><a href="motifwn6.htm#HDRWQ640">Exposure and Redisplay</a></H2> <H2><a href="motifwo6.htm#HDRWQ641">A Widget Case Study: ExmSimple</a></H2> <H1><a href="motifwp6.htm#HDRWQ657">Chapter 13. UIL and WML Compatibility</a></H1> <H2><a href="motifwq6.htm#HDRWQ658">Strategies</a></H2> <H2><a href="motifwr6.htm#HDRWQ659">Providing UIL Access Through Three Small Files</a></H2> <H2><a href="motifws6.htm#HDRWQ664">What is WML?</a></H2> <H2><a href="motifwt6.htm#HDRWQ668">A WML File Example</a></H2> <H2><a href="motifwu6.htm#HDRWQ674">Building a WMD File from Your WML File</a></H2> <H2><a href="motifwv6.htm#HDRWQ675">UIL Compiling with Your WMD File</a></H2> <H1><a href="motifww6.htm#HDRWQ676">Chapter 14. Miscellany</a></H1> <H2><a href="motifwx6.htm#HDRWQ677">Internationalization</a></H2> <H2><a href="motifwy6.htm#HDRWQ678">Binary Compatibility</a></H2> <H1><a href="motifwz6.htm#HDRWQ686">Chapter 15. Widget Printing</a></H1> <H1><a href="motifwa6.htm#HDRWQ688">Chapter 16. Xme Reference Pages</a></H1> <H2><a href="motifwb6.htm#Header_402">XmeAddFocusChangeCallback</a></H2> <H2><a href="motifwc6.htm#Header_403">XmeClearBorder</a></H2> <H2><a href="motifwd6.htm#Header_404">XmeClipboardSink</a></H2> <H2><a href="motifwe6.htm#Header_405">XmeClipboardSource</a></H2> <H2><a href="motifwf6.htm#Header_406">XmeGetDesktopColorCells</a></H2> <H2><a href="motifxp6.htm#Header_407">XmeGetColorObjData</a></H2> <H2><a href="motifyp6.htm#Header_408">XmeConfigureObject</a></H2> <H2><a href="motifzp6.htm#Header_409">XmeConvertMerge</a></H2> <H2><a href="motifap6.htm#Header_410">XmeCreateClassDialog</a></H2> <H2><a href="motifbp6.htm#Header_411">XmeDragSource</a></H2> <H2><a href="motifcp6.htm#Header_412">XmeDrawArrow</a></H2> <H2><a href="motifdp6.htm#Header_413">XmeDrawCircle</a></H2> <H2><a href="motifep6.htm#Header_414">XmeDrawDiamond</a></H2> <H2><a href="motiffp6.htm#Header_415">XmeDrawHighlight</a></H2> <H2><a href="motifgp6.htm#Header_416">XmeDrawIndicator</a></H2> <H2><a href="motifhp6.htm#Header_417">XmeDrawPolygonShadow</a></H2> <H2><a href="motifip6.htm#Header_418">XmeDrawSeparator</a></H2> <H2><a href="motifjp6.htm#Header_419">XmeDrawShadows</a></H2> <H2><a href="motifkp6.htm#Header_420">XmeDropSink</a></H2> <H2><a href="motiflp6.htm#Header_421">XmeFocusIsInShell</a></H2> <H2><a href="motifmp6.htm#Header_422">XmeFromHorizontalPixels</a></H2> <H2><a href="motifnp6.htm#Header_423">XmeFromVerticalPixels</a></H2> <H2><a href="motifop6.htm#Header_424">XmeGetDefaultPixel</a></H2> <H2><a href="motifpp6.htm#Header_425">XmeGetDefaultRenderTable</a></H2> <H2><a href="motifqp6.htm#Header_426">XmeGetDirection</a></H2> <H2><a href="motifrp6.htm#Header_427">XmeGetEncodingAtom</a></H2> <H2><a href="motifsp6.htm#Header_428">XmeGetHomeDirName</a></H2> <H2><a href="motiftp6.htm#Header_429">XmeGetLocalizedString</a></H2> <H2><a href="motifup6.htm#Header_430">XmeGetNextCharacter</a></H2> <H2><a href="motifvp6.htm#Header_431">XmeGetNullCursor</a></H2> <H2><a href="motigfp6.htm#Header_432">XmeGetPixmapData</a></H2> <H2><a href="motihfp6.htm#Header_433">XmeGetTextualDragIcon</a></H2> <H2><a href="motiifp6.htm#Header_434">XmeMicroSleep</a></H2> <H2><a href="motijfp6.htm#Header_435">XmeNamedSink</a></H2> <H2><a href="motikfp6.htm#Header_436">XmeNamedSource</a></H2> <H2><a href="motilfp6.htm#Header_437">XmeNamesAreEqual</a></H2> <H2><a href="motimfp6.htm#Header_438">XmeNavigChangeManaged</a></H2> <H2><a href="motinfp6.htm#Header_439">XmePrimarySink</a></H2> <H2><a href="motiofp6.htm#Header_440">XmePrimarySource</a></H2> <H2><a href="motipfp6.htm#Header_441">XmeQueryBestCursorSize</a></H2> <H2><a href="motiqfp6.htm#Header_442">XmeRedisplayGadgets</a></H2> <H2><a href="motirfp6.htm#Header_443">XmeRemoveFocusChangeCallback</a></H2> <H2><a href="motisfp6.htm#Header_444">XmeRenderTableGetDefaultFont</a></H2> <H2><a href="motitfp6.htm#Header_445">XmeReplyToQueryGeometry</a></H2> <H2><a href="motiufp6.htm#Header_446">XmeResolvePartOffsets</a></H2> <H2><a href="motivfp6.htm#Header_447">XmeSecondarySink</a></H2> <H2><a href="motiwfp6.htm#Header_448">XmeSecondarySource</a></H2> <H2><a href="motixfp6.htm#Header_449">XmeSecondaryTransfer</a></H2> <H2><a href="motiyfp6.htm#Header_450">XmeSetWMShellTitle</a></H2> <H2><a href="motizfp6.htm#Header_451">XmeStandardConvert</a></H2> <H2><a href="motiafp6.htm#Header_452">XmeStandardTargets</a></H2> <H2><a href="motibfp6.htm#Header_453">XmeToHorizontalPixels</a></H2> <H2><a href="moticfp6.htm#Header_454">XmeToVerticalPixels</a></H2> <H2><a href="motidfp6.htm#Header_455">XmeTraitGet</a></H2> <H2><a href="motiefp6.htm#Header_456">XmeTraitSet</a></H2> <H2><a href="motjofp6.htm#Header_457">XmeTransferAddDoneProc</a></H2> <H2><a href="motkofp6.htm#Header_458">XmeVirtualToActualKeysyms</a></H2> <H2><a href="motlofp6.htm#Header_459">XmeWarning</a></H2> <H1><a href="motmofp6.htm#HDRWQ747">Chapter 17. Traits Reference Pages</a></H1> <H2><a href="motnofp6.htm#Header_461">XmQTaccessTextual</a></H2> <H2><a href="motoofp6.htm#Header_465">XmQTactivatable</a></H2> <H2><a href="motpofp6.htm#Header_467">XmQTcareParentVisual</a></H2> <H2><a href="motqofp6.htm#Header_469">XmQTcontainer</a></H2> <H2><a href="motrofp6.htm#Header_471">XmQTcontainerItem</a></H2> <H2><a href="motsofp6.htm#Header_474">XmQTdialogShellSavvy</a></H2> <H2><a href="mottofp6.htm#Header_476">XmQTjoinSide</a></H2> <H2><a href="motuofp6.htm#Header_479">XmQTmenuSavvy</a></H2> <H2><a href="motvofp6.htm#Header_484">XmQTmenuSystem</a></H2> <H2><a href="motwofp6.htm#Header_507">XmQTnavigator</a></H2> <H2><a href="motxofp6.htm#Header_511">XmQTscrollFrame</a></H2> <H2><a href="motyofp6.htm#Header_516">XmQTspecifyRenderTable</a></H2> <H2><a href="motzofp6.htm#Header_518">XmQTtakesDefault</a></H2> <H2><a href="motaofp6.htm#Header_520">XmQTtransfer</a></H2> <H1><a href="motbofp6.htm#HDRWQ762">Chapter 18. Exm Demonstration Widgets Reference Pages</a></H1> <H2><a href="motcofp6.htm#Header_525">ExmCommandButton</a></H2> <H2><a href="motdofp6.htm#Header_533">ExmGrid</a></H2> <H2><a href="moteofp6.htm#Header_539">ExmMenuButton</a></H2> <H2><a href="motfofp6.htm#Header_545">ExmPanner</a></H2> <H2><a href="motgofp6.htm#Header_551">ExmSimple</a></H2> <H2><a href="mothofp6.htm#Header_557">ExmString</a></H2> <H2><a href="mourofp6.htm#Header_563">ExmStringTransfer</a></H2> <H2><a href="movrofp6.htm#Header_572">ExmTabButton</a></H2> <H1><a href="mowrofp6.htm#Header_578">Glossary</a></H1>