Product Description
Volume 6B, Motif Reference Manual, is a complete programmer's reference for the Motif toolkit. The Motif toolkit provides a complete set of widgets, such as buttons, scroll bars, menus, and dialog boxes, for developing graphical user interfaces. It also includes a library of functions for creating and manipulating those widgets. The second edition of the Motif Reference Manual covers Motif 2.1, the latest release of Motif. The contents of this book include:
- Reference pages for the widget classes defined by the Motif toolkit and the X Toolkit Intrinsics. Each reference page fully describes the widget's functionality, including its new and inherited resources, callback routines, and translations.
- Documentation on all of the Motif functions and macros that create and manipulate widgets and other Motif data types, such as compound strings and render tables.
- Reference material for the Motif Window Manager (mwm), a window manager designed to be compatible with the appearance and behavior of the Motif widget set.
- Descriptions of all the data types used by Motif functions.
- A list of all the new widget classes, functions, and widget resources in Motif 2.1 and 2.0.
This book is designed to be used with Volume 6A, Motif Programming Manual, which describes how to build applications using the Motif toolkit and provides a complete tutorial with programming examples. Both of these books are an integral part of the X Window System series from O'Reilly.
From the Publisher
About the Author
Antony Fountain is a Principal Engineer at Imperial Software Technology, where he has worked on a number of X/Motif products, including X-Designer, a world-leading Motif GUI builder tool. Aside from development, he has written and delivered X/Motif widget/graphics training courses and developed the front ends to several external products as a consultant. He has been working with X/Motif for well over 10 years. Antony has an M.A. in English Language and Literature from Edinburgh, with sidelines in Applied Mathematics and Computer Science, and a postgraduate M.Sc. in Computer Science from Heriot-Watt (Edinburgh).
Excerpted from Motif Reference Manual Vol 6B by Antony Fountain, Paula Ferguson. Copyright © 2000. Reprinted by permission. All rights reserved.
This appendix provides a summary of the new features in Motif 2.1 and 2.0. It lists the new toolkit functions and widget classes in Motif 2.1 and 2.0, as well as any new resources added to existing widget classes. For more information on the functions and widgets, see the appropriate reference pages in Section 1, Motif Functions and Macros, and Section 2, Motif and Xt Widget Classes.
New Toolkit Functions
XmComboBoxAddItem()
Adds an item to a ComboBox.
XmComboBoxDeletePos()
Deletes an item from a ComboBox.
XmComboBoxSelectItem()
Selects an item in a ComboBox.
XmComboBoxSetItem()
Selects and makes visible an item in a ComboBox.
XmComboBoxUpdate()
Update the state of a ComboBox.
XmContainerCopy()
Copy selected Container items to the clipboard.
XmContainerCopyLink()
Copy links to selected Container items to the clipboard.
XmContainerCut()
Cut selected Container items to the clipboard.
XmContainerGetItemChildren()
Retrieve the logical children of a Container item.
XmContainerPaste()
Copy clipboard data into a Container.
XmContainerPasteLink()
Copy links to clipboard data into a Container.
XmContainerRelayout()
Force the relayout of Container items.
XmContainerReorder()
Sort the items within a Container.
XmConvertStringToUnits()
Convert a unit specification expressed as a string to an integral value.
XmCvtByteStreamToXmString()
Convert a byte stream representation to a compound string.
XmCvtTextPropertyToXmStringTable()
Convert a text property to a compound string table.
XmCvtXmStringTableToTextProperty()
Convert a compound string table to a text property.
XmCvtXmStringToByteStream()
Convert a compound string to a byte stream representation.
XmDirectionMatch()
Compare two XmDirection quantities.
XmDirectionMatchPartial()
Loosely compare two XmDirection quantities.
XmDirectionToStringDirection()
Convert an XmDirection type to a XmStringDirection type.
XmFontListCreate_r()
Create an XmFontList in a thread-safe manner.
XmFontListEntryCreate_r()
Create an XmFontListEntry in a thread-safe manner.
XmGetScaledPixmap()
Read a pixmap and scale it for printing.
XmImCloseXIM()
Close all input contexts.
XmImFreeXIC()
Free an input context.
XmImGetXIC()
Create an input context for a widget.
XmImMbResetIC()
Reset an input context.
XmImSetXIC()
Register a widget with an existing input context.
XmNotebookGetPageInfo()
Retrieve data about a Notebook page.
XmObjectAtPoint()
Find the widget most closely associated with a point.
XmParseMappingCreate()
Create a parse mapping object.
XmParseMappingFree()
Free a parse mapping object.
XmParseMappingGetValues()
Retrieve the values of a parse mapping object.
XmParseMappingSetValues()
Set the values of a parse mapping object.
XmParseTableFree()
Free an array of parse mapping objects.
XmPrintPopupPDM()
Issue a request to the Print Display Manager.
XmPrintSetup()
Initialize a PrintShell and X Print connection.
XmPrintToFile()
Print X Print Server data to file.
XmRedisplayWidget()
Synchronously force a widget to expose itself.
XmRenderTableAddRenditions()
Add rendition objects to a render table.
XmRenderTableCopy()
Copy a render table.
XmRenderTableCvtFromProp()
Convert a text property into a render table.
XmRenderTableCvtToProp()
Convert a render table to a text property.
XmRenderTableFree()
Free a render table.
XmRenderTableGetRendition()
Find a rendition object in a render table.
XmRenderTableGetRenditions()
Find a group of rendition objects in a render table.
XmRenderTableGetTags()
Retrieve all the rendition tags in a render table.
XmRenderTableRemoveRenditions()
Remove renditions from a render table.
XmRenditionCreate()
Create a rendition object.
XmRenditionFree()
Free a rendition object.
XmRenditionRetrieve()
Retrieve the values of a rendition object.
XmRenditionUpdate()
Set the values of a rendition object.
XmScaleSetTicks()
Place tick marks along the edge of a Scale.
XmSimpleSpinBoxAddItem()
Add an item to a SimpleSpinBox.
XmSimpleSpinBoxDeletePos()
Delete an item from a SimpleSpinBox.
XmSimpleSpinBoxSetItem()
Select an item in a SimpleSpinBox.
XmSpinBoxValidatePosition()
Validate a position in a SpinBox.
XmStringByteStreamLength()
Return the length of a byte stream representation of a compound string.
XmStringComponentCreate()
Create a component in a compound string.
XmStringConcatAndFree()
Concatenate two compound strings, and free the originals.
XmStringDirectionToDirection()
Convert an XmStringDirection type into an XmDirection type.
XmStringGenerate()
Generate a new compound string using the default parse table.
XmStringGetNextTriple()
Retrieve the type, length, and value of the next compound string component.
XmStringIsVoid()
Check if a compound string is empty of components.
XmStringParseText()
Convert a string into a compound string using a parse table.
XmStringPeekNextTriple()
Look ahead at the type of the next compound string component.
XmStringPutRendition()
Add rendition components around a compound string.
XmStringTableParseStringArray()
Convert an array of strings into an array of compound strings using a parse table.
XmStringTableProposeTablist()
Calculate an XmTabList for a compound string.
XmStringTableToXmString()
Convert a compound string table into a compound string.
XmStringTableUnparse()
Convert an array of compound strings into an array of strings using a parse table.
XmStringToXmStringTable()
Convert a string into an array of compound strings.
XmStringUnparse()
Convert a compound string into a string using a parse table.
XmTabCreate()
Create a new XmTab object.
XmTabFree()
Free an XmTab object.
XmTabGetValues()
Retrieve the values of an XmTab object.
XmTabListCopy()
Copy an array of XmTab objects.
XmTabListFree()
Free an array of XmTab objects.
XmTabListGetTab()
Find an XmTab object within an array.
XmTabListInsertTabs()
Add XmTab objects to an array of tabs.
XmTabListRemoveTabs()
Remove XmTab objects from an array of tabs.
XmTabListReplacePositions()
Replace XmTab objects within an array of tabs.
XmTabListTabCount()
Return the number of XmTab objects in an array of tabs.
XmTabSetValue()
Set the value of an XmTab object.
XmTextCopyLink()
Copy a link to the primary selection into the clipboard.
XmTextGetCenterline()
Return the centerline of a vertically oriented text string.
XmTextPasteLink()
Copy a link from the clipboard selection at the insertion cursor.
XmToggleButtonSetValue()
Set the value of a tri-state ToggleButton.
XmTransferDone()
Signal the end of data transfer operations.
XmTransferSendRequest()
Transmit a multiple data transfer request.
XmTransferSetParameters()
Specify parameters for the next data transfer request.
XmTransferStartRequest()
Initiate a multiple data transfer request.
XmTransferValue()
Issue a data transfer request.
