5 The MLWorks Motif Interface Library

5.10 Identifier reference

Most functions are grouped into substructures. Each substructure defines operations on a particular type or a particular sort of widget.

The following tables contain mappings from MLWorks Motif interface library identifiers to their corresponding X Window System and Motif identifiers

Table 5.2 Top-level Xm structure identifiers
ML identifier	C identifier
`isMotifWMRunning`	`XmIsMotifWMRunning`
`updateDisplay`	`XmUpdateDisplay`
`sync`	`XSync`
`synchronize`	`XSynchronize`

Table 5.3 `Display` structure identifiers
ML identifier	C identifier
`bell`	`Xbell`
`queryPointer`	`XQueryPointer`

Table 5.4 `Pixel` structure identifiers
ML identifier	C identifier
`screenBlack`	`BlackPixelOfScreen`
`screenWhite`	`WhitePixelOfScreen`

Table 5.5 `Font` structure identifiers
ML identifier	C identifier
`load`	`XLoadFont`
`free`	`XFreeFont`
`query`	`XQueryFont`
`textExtents`	`XTextExtents`

Table 5.6 `Widget` structure identifiers
ML identifier	C identifier
`create`	`XtCreateWidget`
`createMenuBar`	`XmCreateMenuBar`
`createPopupShell`	`XtCreatePopupShell`
`createPulldownMenu`	`XmCreatePulldownMenu`
`createScrolledText`	`XmCreateScrolledText`
`createManaged`	`Xm.Widget.create` followed by `Xm.Widget.manage`
`destroy`	`XtDestroyWidget`
`manage`	`XtManageChild`
`map`	`XtMapWidget`
`unmanageChild`	`XtUnmanageChild`
`unmap`	`XtUnMapWidget`
`realize`	`XtRealizeWidget`
`unrealize`	`XtUnrealizeWidget`
`isRealized`	`XtIsRealized`
`popup`	`XtPopup`
`valuesSet`	`XtSetValues`
`valuesGet`	`XtGetValues`
`display`	`XtDisplay`
`window`	`XtWindow`
`screen`	`XtScreen`
`parent`	`XtParent`
`name`	`XtName`
`processTraversal`	`XmProcessTraversal`
`toFront`	Brings widget to the front using `XReconfigureWMWindow`.

Table 5.7 `Atom` structure identifiers
ML identifier	C identifier
`intern`	`XmInternAtom`
`getname`	`XmGetAtomName`

Table 5.8 `Pixmap` structure identifiers
ML identifier	C identifier
`create`	`XCreatePixmap`
`free`	`XFreePixmap`
`get`	`XmGetPixmap`
`destroy`	`XmDestroyPixmap`

Table 5.9 `CascadeButton` structure identifier
ML identifier	C identifier
`highlight`	`XmCascadeButtonHighlight`

Table 5.10 `CascadeButtonGadget` structure identifier
ML identifier	C identifier
`highlight`	`XmCascadeButtonGadgetHighlight`

Table 5.11 `CompoundString` structure identifiers
ML identifier	C identifier
`baseline`	`XmStringBaseline`
`byteCompare`	`XmStringByteCompare`
`compare`	`XmStringCompare`
`concat`	`XmStringConcat`
`copy`	`XmStringCopy`
`create`	`XmStringCreate`
`createLtoR`	`XmStringCreateLtoR`
`createSimple`	`XmStringCreateSimple`
`directionCreate`	`XmStringDirectionCreate`
`empty`	`XmStringEmpty`
`extent`	`XmStringExtent`
`free`	`XmStringFree`
`hasSubstring`	`XmStringHasSubstring`
`height`	`XmStringHeight`
`length`	`XmStringLength`
`lineCount`	`XmStringLineCount`
`nConcat`	`XmStringNConcat`
`nCopy`	`XmStringNCopy`
`width`	`XmStringWidth`
`convertStringText`	no corresponding identifier

The function convertStringText is a convenience function that extracts a simple string from a compound string.

Table 5.12 `FileSelectionBox` structure identifiers
ML identifier	C identifier
`getChild`	`XmFileSelectionBoxGetChild`
`doSearch`	`XmFileSelectionDoSearch`

Table 5.13 `FontList` structure identifiers
ML identifier	C identifier
`add`	`XmFontListAdd`
`copy`	`XmFontListCopy`
`create`	`XmFontListCreate`
`free`	`XmFontListFree`

Table 5.14 `List` structure identifiers
ML identifiers	C identifiers
`addItem`	`XmListAddItem`
`addItemUnselected`	`XmListAddItemUnselected`
`addItems`	`XmListAddItems`
`deleteAllItems`	`XmListDeleteAllItems`
`deleteItem`	`XmListDeleteItem`
`deleteItems`	`XmListDeleteItems`
`deleteItemsPos`	`XmListDeleteItemsPos`
`deletePos`	`XmListDeletePos`
`getSelectedPos`	`XmListGetSelectedPos`
`setBottomPos`	`XmListSetBottomPos`
`selectPos`	`XmListSelectPos`
`setPos`	`XmListSetPos`

Table 5.15 `MessageBox` structure identifier
ML identifier	C identifier
`getChild`	`XmMessageBoxGetChild`

Table 5.16 `Scale` structure identifiers
ML identifier	C identifier
`getValue`	`XmScaleGetValue`
`setValue`	`XmScaleSetValue`

Table 5.17 `ScrollBar` structure identifiers
ML identifier	C identifier
`getValues`	`XmScrollBarGetValues`
`setValues`	`XmScrollBarSetValues`

Table 5.18 `ScrolledWindow` structure identifier
ML identifier	C identifier
`setAreas`	`XmScrolledWindowSetAreas`

Table 5.19 `SelectionBox` structure identifier
ML identifier	C identifier
`getChild`	`XmSelectionBoxGetChild`

Table 5.20 `TabGroup` structure identifiers
ML identifier	C identifier
`add`	`XmAddTabGroup`
`remove`	`XmRemoveTabGroup`

Table 5.21 `Text` structure identifies
ML identifier	C identifier
`clearSelection`	`XmTextClearSelection`
`copy`	`XmTextCopy`
`cut`	`XmTextCut`
`getBaseline`	`XmTextGetBaseline`
`getEditable`	`XmTextGetEditable`
`getMaxLength`	`XmTextGetMaxLength`
`getInsertionPosition`	`XmTextGetInsertionPosition`
`getLastPosition`	`XmTextGetLastPosition`
`getSelection`	`XmTextGetSelection`
`getSelectionPosition`	`XmTextGetSelectionPosition`
`getString`	`XmTextGetString`
`getTopCharacter`	`XmTextGetTopCharacter`
`insert`	`XmTextInsert`
`paste`	`XmTextPaste`
`posToXY`	`XmTextPosToXY` Failure returns (-1, -1).
`remove`	`XmTextRemove` Ignores return value.
`replace`	`XmTextReplace`
`scroll`	`XmTextScroll`
`setAddMode`	`XmTextSetAddMode`
`setEditable`	`XmTextSetEditable`
`setHighlight`	`XmTextSetHighlight`
`setInsertionPosition`	`XmTextSetInsertionPosition`
`setMaxLength`	`XmTextSetMaxLength`
`setSelection`	`XmTextSetSelection`
`setString`	`XmTextSetString`
`setTopCharacter`	`XmTextSetTopCharacter`
`showPosition`	`XmTextShowPosition`
`xyToPos`	`XmTextXyToPos`

Table 5.22 `ToggleButton` structure identifiers
ML identifier	C identifier
`getState`	`XmToggleButtonGetState`
`setState`	`XmToggleButtonSetState`

Table 5.23 `ToggleButtonGadget` structure identifiers
ML identifier	C identifier
`getState`	`XmToggleButtonGadgetGetState`
`setState`	`XmToggleButtonGadgetSetState`

Table 5.24 `Translation` structure identifiers
ML identifier	C identifier
`parseTable`	`XtParseTranslationTable`
`override`	`XtOverrideTranslations`
`augment`	`XtAugmentTranslations`
`uninstall`	`XtUninstallTranslations`

The following structures provide Xlib graphics capabilities:

Table 5.25 `GC` structure identifiers
ML identifiers	C identifiers
`create`	`XCreateGC`
`change`	`XChangeGC`
`copy`	`XCopyGC`
`free`	`XFreeGC`
`setClipRectangles`	`XSetClipRectangles`
`getValues`	`XGetGCValues`

The gc_value datatype, and the types on which it depends, enumerate the possible values that may be set in a GC. The request datatype enumerates the same values for the getValues function.

Table 5.26 `Draw` structure interfaces
ML interface	C interface
`string`	`XDrawString`
`imageString`	`XDrawImageString`
`line`	`XDrawLine`
`lines`	`XDrawLines`
`segments`	`XDrawSegments`
`fillPolygon`	`XFillPolygon`
`point`	`XDrawPoint`
`points`	`XDrawPoints`
`rectangle`	`XDrawRectangle`
`fillRectangle`	`XFillRectangle`
`rectangles`	`XDrawRectangles`
`fillRectangles`	`XFillRectangles`
`arc`	`XDrawArc`
`fillArc`	`XFillArc`
`arcs`	`XDrawArcs`
`fillArcs`	`XFillArcs`
`clearArea`	`XClearArea`
`copyArea`	`XCopyArea`
`copyPlane`	`XCopyPlane`

Table 5.27 `Colormap` structure identifiers
ML identifier	C identifier
`default`	`DefaultColormapOfScreen`
`allocColor`	`XAllocColor`
`allocNamedColor`	`XAllocNamedColor`
`allocColorCells`	`XAllocColorCells`
`freeColors`	`XFreeColors`
`storeColor`	`XStoreColor`
`storeNamedColor`	`XStoreNamedColor`