NAME
_Xm* - LessTif Internal Functions
DESCRIPTION
When the LessTif project began some discussion was undertaken about the
use of the previously undocumented internal _Xm.. functions in Motif
1.2. Apparently many of those functions have been transformed to Xme..
functions in OSF/Motif® 2.x and are also documented. As many people
use these functions in their code (especially widget writers) the
implementation of the _Xm.. functions is important to the LessTif
project.
Below is a (outdated!) list of functions currently taken from the
LessTif header files.
CONVENIENCE FUNCTIONS
void _XmCalcLabelDimensions(Widget w);
Sets the core width and height values to the values needed to display
the current label contents. It takes into account the label type as
well as all of the margin resources.
Boolean _XmGetInDragMode(Widget w);
returns True, if the widget (e.g. push button,...) resides in a menu
and the user is currently dragging the mouse with button 1 pressed over
the menu items. This way a widget can figure out, whether it must
redraw itself in the armed state if the widget gets a PrimitiveEnter
action.
Boolean _XmIsEventUnique(XEvent *event);
Unknown Function
Widget _XmGetRC_PopupPosted(Widget w);
Returns the widget id of the parent of the menu that is currently
posted by any of the children of w. In other words the id of the shell
that is cascaded from menu w.
void _XmRecordEvent(XEvent *event);
Unknown Function
void _XmSetInDragMode(Widget w, Boolean flag);
this is used to enter or leave the dragging mode within the menu
system.
XmFontListEntry _XmFontListEntryFromTag(XmFontList fontlist, char
*tag);
Unknown Function
Boolean _XmCreateVisibilityRect(Widget w, XRectangle *rectPtr);
Unknown Function
Boolean _XmCvtStringToXmNavigation(Display *, XrmValue *, Cardinal *,
XrmValue *, XrmValue *, XtPointer *);
Unknown Function
Boolean _XmCvtStringToXmString(Display *, XrmValue *, Cardinal *,
XrmValue *, XrmValue *, XtPointer *);
Unknown Function
Boolean _XmFocusIsHere(Widget w);
Unknown Function
Boolean _XmFocusIsInShell(Widget wid);
Unknown Function
Boolean _XmGrabTheFocus(Widget w, XEvent *event);
Unknown Function
Boolean _XmIsNavigable(Widget wid);
Unknown Function
Boolean _XmNavigSetValues(Widget current, Widget request, Widget
new_wid, ArgList args, Cardinal *num_args);
Unknown Function
Boolean _XmSearchColorCache(unsigned int which, XmColorData *values,
XmColorData **ret);
Unknown Function
Boolean _XmShellIsExclusive(Widget wid);
Unknown Function
Boolean _XmStringsAreEqual()
Unknown Function
Pixel _XmAccessColorData(XmColorData *cd, unsigned char which);
Unknown Function
Pixel _XmBlackPixel(Screen *screen, Colormap colormap, XColor
blackcolor);
Unknown Function
Pixel _XmWhitePixel(Screen *screen, Colormap colormap, XColor
whitecolor);
Unknown Function
Pixmap _XmGetPixmap();
Unknown Function
String _XmGetDefaultBackgroundColorSpec(Screen *screen);
Unknown Function
Time __XmGetDefaultTime(Widget w, XEvent *event);
Unknown Function
Widget _XmFindNextTabGroup(Widget wid);
Unknown Function
Widget _XmFindPrevTabGroup(Widget wid);
Unknown Function
Widget _XmFindTopMostShell(Widget w);
Unknown Function
Widget _XmGetActiveItem(Widget w);
Unknown Function
Widget _XmGetFirstFocus(Widget wid);
Unknown Function
Widget _XmNavigate(Widget wid, XmTraversalDirection direction);
Unknown Function
XmColorData *_XmAddToColorCache(XmColorData *new_rec);
Unknown Function
XmColorData *_XmGetColors(Screen *screen, Colormap color_map, Pixel
background);
Unknown Function
XmColorData *_XmGetDefaultColors(Screen *screen, Colormap color_map);
Unknown Function
XmFocusData _XmCreateFocusData();
Unknown Function
XmFocusData _XmGetFocusData(Widget wid);
Unknown Function
XmFontList _XmGetDefaultFontList(Widget w, unsigned char fontListType);
Unknown Function
XmGadget _XmInputForGadget(Widget cw, int x, int y);
Unknown Function
XmGadget _XmInputInGadget(Widget cw, int x, int y);
Unknown Function
char * _XmGetBGPixmapName();
Unknown Function
char *_XmConvertCSToString(XmString cs);
Unknown Function
int _XmEmptyRect(XRectangle *r);
Unknown Function
int _XmIntersectRect(XRectangle *srcRectA, Widget widget, XRectangle
*dstRect);
Unknown Function
unsigned char _XmGetFocusPolicy(Widget w);
Unknown Function
void _XmBackgroundColorDefault(Widget widget, int offset, XrmValue
*value);
Unknown Function
void _XmBottomShadowColorDefault(Widget widget, int offset, XrmValue
*value);
Unknown Function
void _XmCallFocusMoved(Widget old, Widget new_wid, XEvent *event);
Unknown Function
void _XmClearBGPixmap();
Unknown Function
void _XmClearFocusPath(Widget wid);
Unknown Function
void _XmClearRect(XRectangle *r);
Unknown Function
void _XmConfigureObject(Widget g, Position x, Position y, Dimension
width, Dimension height, Dimension border_width);
_XmConfigureObject is a wrapper around XtConfigureWidget(3) which
insulates a widget writer from the burden of checking whether an object
is a widget or a gadget. The way for a manager widget (any subclass of
XmManager; they’re supposed to do geometry management for their
children) to set the layout of a child is to use this function. In the
case of a widget, XtConfigureWidget is called. For a gadget, the
geometry fields are manipulated directly.
void _XmDestroyFocusData(XmFocusData focusData);
Unknown Function
void _XmDispatchGadgetInput(Widget g, XEvent *event, Mask mask);
Unknown Function
void _XmFocusModelChanged(Widget wid, XtPointer client_data, XtPointer
call_data);
Unknown Function
void _XmForegroundColorDefault(Widget widget, int offset, XrmValue
*value);
Unknown Function
void _XmGetDefaultThresholdsForScreen(Widget widget, int offset,
XrmValue *value);
Unknown Function
void _XmHighlightColorDefault(Widget widget, int offset, XrmValue
*value);
Unknown Function
void _XmManagerHighlightPixmapDefault(Widget widget, int offset,
XrmValue *value);
Unknown Function
void _XmManagerTopShadowPixmapDefault(Widget widget, int offset,
XrmValue *value);
Unknown Function
void _XmMgrTraversal(Widget wid, XmTraversalDirection direction);
Unknown Function
void _XmMoveObject(Widget g, Position x, Position y);
Unknown Function
void _XmNavigChangeManaged(Widget wid);
Unknown Function
void _XmNavigDestroy(Widget wid);
Unknown Function
void _XmNavigInitialize(Widget request, Widget new_wid, ArgList args,
Cardinal num_args);
Unknown Function
void _XmNavigResize(Widget wid);
Unknown Function
void _XmPrimitiveEnter(Widget w, XEvent *event, String *params,
Cardinal num_params);
Unknown Function
void _XmPrimitiveHighlightPixmapDefault(Widget widget, int offset,
XrmValue *value);
Unknown Function
void _XmPrimitiveLeave(Widget w, XEvent *event, String *params,
Cardinal num_params);
Unknown Function
void _XmPrimitiveTopShadowPixmapDefault(Widget widget, int offset,
XrmValue *value);
Unknown Function
void _XmProcessTraversal(Widget w, XmTraversalDirection dir, Boolean
check);
Unknown Function
void _XmRedisplayGadgets(Widget w, XEvent *event, Region region);
Unknown Function
void _XmRegisterConverters();
Unknown Function
void _XmRegisterPixmapConverters();
Unknown Function
void _XmResetTravGraph(Widget wid);
Unknown Function
void _XmResizeObject(Widget g, Dimension width, Dimension height,
Dimension border_width);
Unknown Function
void _XmSetActiveTabGroup(XmFocusData focusData, Widget tabGroup);
Unknown Function
void _XmSetDefaultBackgroundColorSpec(Screen *screen, String
new_color_spec);
Unknown Function
void _XmSetInitialOfTabGroup(Widget tab_group, Widget init_focus);
Unknown Function
void _XmSetRect(XRectangle *rect, Widget w);
Unknown Function
void _XmTopShadowColorDefault(Widget widget, int offset, XrmValue
*value);
Unknown Function
void _XmValidateFocus(Widget wid);
Unknown Function
void _XmWarning(Widget w, char *message);
Unknown Function
void _XmWidgetFocusChange(Widget wid, XmFocusChange change);
Unknown Function
void _XmCascadePixmapDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmClearBorder(Display *display, Window win, int x, int y,
Dimension width, Dimension height, Dimension shadow_thickness)
Unknown Function
void _XmDefaultButtonShadowThickness(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmDefaultMultiClick(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmDrawArrow(Display *display, Window win, GC bottomGC, GC topGC,
GC fillGC, Position x, Position y, Dimension width, Dimension height,
Dimension shadow_thickness, unsigned char direction);
Unknown Function
void _XmDrawDiamond(Display *display, Window win, GC bottomGC, GC
topGC, GC selectGC, Position x, Position y, Dimension width, Dimension
height, Dimension shadowThickness, Dimension fill);
Unknown Function
void _XmDrawSeparator(Display *display, Window win, GC top_gc, GC
bottom_gc, separator_GC, Position wx, Position wy, Dimension wwidth,
Dimension wheight, Dimension shadowThickness, Dimension margin,
unsigned char orientation, unsigned char separator_type);
Unknown Function
void _XmDrawShadowDisplay *display, Drawable d, GC top_gc, GC
bottom_gc, Dimension shad_thick, Position x, Position y, Dimension
width, Dimension height);
Unknown Function
void _XmDrawShadows(Display *display, Window win, GC topShadowGC, GC
bottomShadowGC, Position x, Position y, Dimension width, Dimension
height, Dimension shadowThickness, unsigned int shadowType);
Unknown Function
void _XmFontListGetDefaultFont(XmFontList fontlist, XFontStruct
**font_struct);
Unknown Function
void _XmFrameHorizSpaceDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmFrameShadowThicknessDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmFrameShadowTypeDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmInitializeWidgetSet();
Unknown Function
void _XmRowColumnEntryClassDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmRowColumnIsHomogeneousDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmRowColumnMarginDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmRowColumnMenuAcceleratorDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmRowColumnPackingDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmRowColumnSpacingDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmScrollBarMaximumDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmScrollBarProcessingDirectionDefault(Widget w, int offset,
XrmValue *val);
Unknown Function
void _XmScrollBarSliderSizeDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmScrollBarTroughColorDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmScrollBarValueDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmSelectColorDefault(Widget w, int offset, XrmValue *val);
Unknown Function
void _XmToggleButtonIndicatorTypeDefault(Widget w, int offset, XrmValue
*val);
Unknown Function
void _XmVendorShellVirtualBindingsDefault(Widget w, int offset,
XrmValue *val);
Unknown Function
String _XmOSGetHomeDirName(void);
Unknown Function
XmString _XmOSGetLocalizedString(char *reserved,
Unknown Function
int _XmMicroSleep(long secs);
Unknown Function
void _XmInternAtomAndName(Display *display, Atom atom, String name);
Associates an atom name with an atom id (and vice versa) without the
need to query the X server first for the atom id. This way any name to
id mapping (as well as the id to name mapping) can be set on a given
display.
void _XmVirtualToActualKeysym(Display *Dsp, KeySym VirtualKeysym,
KeySym *RealKeysymReturn, Modifiers *ModifierReturn);
For the given virtual keysym (which must be one of the = osfXK_xxx
keysyms) returns the real keysym as well as the modifiers which make up
that particular virtual keysym. If asked for an invalid virtual
keysym, _XmVirtualToActualKeysym returns NoSymbol for the real keysym.
int _XmVirtKeysLoadFallbackBindings(Display *Dsp, String *Bindings);
Installs the default key bindings for a specific display. If th= ere
are any vendor specific default bindings available, then the appropiate
one= will be installed instead of the fallback key bindings.
Additionally, the bindings installed are returned in Bindings. The
caller is responsible for freeing the space occupied by this key
binding description string. The return code seems to be always zero. At
least LessTif will always retur= n a zero...
Boolean _XmVirtKeysLoadFileBindings(String filename, String *binding=
);
Reads in a file containing a description of the virtual key bindings.
If succesful, returns True and the description string. The caller= is
responsible for freeing the memory lateron.
void _XmVirtKeysInitialize(Widget w);
Sets up the virtual key bindings for a display. The widget specified
must be a XmDisplay widget, otherwise _XmVirtKeysInitialize will deny
the attempt to set up the key bindings. The function first checks
several places in order to catch up key binding description. If all
fails, it will install fallback key bindings. This internal function is
called during when initializing a XmDisplay widget.
void _XmVirtKeysDestroy(Widget w);
Cleanup any leftovers from the virtual binding mechanism when
destroying a XmDisplay widget.
void _XmVirtKeysHandler(Widget w, XtPointer Data, XEvent *Event,
Boolean *ContDispatch);
This handler is installed on every widget. It just records the current
key press event in an widget instance field private to a XmDisplay
widget.
SEE ALSO
lesstif(1x)