.\".\" $Header: /cvsroot/lesstif/lesstif/doc/lessdox/widgets/LessTifInternals.3,v 1.5 2001/01/09 09:19:02 amai Exp $.\".\" Copyright (C) 1997-1998 Free Software Foundation, Inc..\" .\" This file is part of the GNU LessTif Library..\" This library is free software; you can redistribute it and/or.\" modify it under the terms of the GNU Library General Public.\" License as published by the Free Software Foundation; either.\" version 2 of the License, or (at your option) any later version..\" .\" This library is distributed in the hope that it will be useful,.\" but WITHOUT ANY WARRANTY; without even the implied warranty of.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU.\" Library General Public License for more details..\" .\" You should have received a copy of the GNU Library General Public.\" License along with this library; if not, write to the Free.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA..\" .TH "LessTif Internal Functions" 3 "April 1998" "LessTif Project" "LessTif Manuals".SH NAMELessTif Internal Functions.SH DESCRIPTIONWhen the LessTif project began some discussion was undertakenabout the use of the previously undocumentedinternal _Xm.. functions in Motif 1.2.Apparently many of those functions have been transformed to Xme.. functionsin OSF/Motif\(rg 2.x and are also documented.As many people use these functions in their code(especially widget writers) the implementation of the _Xm.. functionsis important to the LessTif project..PPBelow is a (outdated!) list of functions currently taken from the LessTif header files. .SH CONVENIENCE FUNCTIONS.PP.BR "void _XmCalcLabelDimensions(Widget w);".PPSets the core width and height values to the values needed to display the currentlabel contents.  It takes into account the label type as well as all of the marginresources..PP.BR "Boolean _XmGetInDragMode(Widget w);".PPreturns True, if the widget (e.g. push button,...)resides in a menu and the user is currently dragging themouse with button 1 pressed over the menu items.This way a widget can figure out, whether it mustredraw itself in the armed state if the widget gets a PrimitiveEnter action. .PP.BR "Boolean _XmIsEventUnique(XEvent *event);".PPUnknown Function .PP.BR "Widget _XmGetRC_PopupPosted(Widget w);".PPReturns the widget id of the parent of the menu that is currently posted byany of the children of w.  In other words the id of the shell that is cascadedfrom menu w..PP.BR "void _XmRecordEvent(XEvent *event); ".PPUnknown Function .PP.BR "void _XmSetInDragMode(Widget w, Boolean flag);".PPthis is used to enter or leave the dragging mode within the menu system. .PP.BR "XmFontListEntry _XmFontListEntryFromTag(XmFontList fontlist, char *tag);".PPUnknown Function .PP.BR "Boolean _XmCreateVisibilityRect(Widget w, XRectangle *rectPtr);".PPUnknown Function .PP.BR "Boolean _XmCvtStringToXmNavigation(Display *, XrmValue *, Cardinal *, XrmValue *, XrmValue *, XtPointer *);".PPUnknown Function .PP.BR "Boolean _XmCvtStringToXmString(Display *, XrmValue *, Cardinal *, XrmValue *, XrmValue *, XtPointer *);".PPUnknown Function .PP.BR "Boolean _XmFocusIsHere(Widget w);".PPUnknown Function .PP.BR "Boolean _XmFocusIsInShell(Widget wid);".PPUnknown Function .PP.BR "Boolean _XmGrabTheFocus(Widget w, XEvent *event);".PPUnknown Function .PP.BR "Boolean _XmIsNavigable(Widget wid);".PPUnknown Function .PP.BR "Boolean _XmNavigSetValues(Widget current, Widget request, Widget new_wid, ArgList args, Cardinal *num_args);".PPUnknown Function .PP.BR "Boolean _XmSearchColorCache(unsigned int which, XmColorData *values, XmColorData **ret);".PPUnknown Function .PP.BR "Boolean _XmShellIsExclusive(Widget wid);".PPUnknown Function .PP.BR "Boolean _XmStringsAreEqual() ".PPUnknown Function .PP.BR "Pixel _XmAccessColorData(XmColorData *cd, unsigned char which);".PPUnknown Function .PP.BR "Pixel _XmBlackPixel(Screen *screen, Colormap colormap, XColor blackcolor);".PPUnknown Function .PP.BR "Pixel _XmWhitePixel(Screen *screen, Colormap colormap, XColor whitecolor);".PPUnknown Function .PP.BR "Pixmap _XmGetPixmap();".PPUnknown Function .PP.BR "String _XmGetDefaultBackgroundColorSpec(Screen *screen);".PPUnknown Function .PP.BR "Time __XmGetDefaultTime(Widget w, XEvent *event);".PPUnknown Function .PP.BR "Widget _XmFindNextTabGroup(Widget wid);".PPUnknown Function .PP.BR "Widget _XmFindPrevTabGroup(Widget wid);".PPUnknown Function .PP.BR "Widget _XmFindTopMostShell(Widget w);".PPUnknown Function .PP.BR "Widget _XmGetActiveItem(Widget w);".PPUnknown Function .PP.BR "Widget _XmGetFirstFocus(Widget wid);".PPUnknown Function .PP.BR "Widget _XmNavigate(Widget wid, XmTraversalDirection direction);".PPUnknown Function .PP.BR "XmColorData *_XmAddToColorCache(XmColorData *new_rec);".PPUnknown Function .PP.BR "XmColorData *_XmGetColors(Screen *screen, Colormap color_map, Pixel background);".PPUnknown Function .PP.BR "XmColorData *_XmGetDefaultColors(Screen *screen, Colormap color_map);".PPUnknown Function .PP.BR "XmFocusData _XmCreateFocusData();".PPUnknown Function .PP.BR "XmFocusData _XmGetFocusData(Widget wid);".PPUnknown Function .PP.BR "XmFontList _XmGetDefaultFontList(Widget w, unsigned char fontListType);".PPUnknown Function .PP.BR "XmGadget _XmInputForGadget(Widget cw, int x, int y);".PPUnknown Function .PP.BR "XmGadget _XmInputInGadget(Widget cw, int x, int y);".PPUnknown Function .PP.BR "char * _XmGetBGPixmapName();".PPUnknown Function .PP.BR "char *_XmConvertCSToString(XmString cs);".PPUnknown Function .PP.BR "int _XmEmptyRect(XRectangle *r);".PPUnknown Function .PP.BR "int _XmIntersectRect(XRectangle *srcRectA, Widget widget, XRectangle *dstRect);".PPUnknown Function .PP.BR "unsigned char _XmGetFocusPolicy(Widget w);".PPUnknown Function .PP.BR "void _XmBackgroundColorDefault(Widget widget, int offset, XrmValue *value);".PPUnknown Function .PP.BR "void _XmBottomShadowColorDefault(Widget widget, int offset, XrmValue *value);".PPUnknown Function .PP.BR "void _XmCallFocusMoved(Widget old, Widget new_wid, XEvent *event);".PPUnknown Function .PP.BR "void _XmClearBGPixmap();".PPUnknown Function .PP.BR "void _XmClearFocusPath(Widget wid);".PPUnknown Function .PP.BR "void _XmClearRect(XRectangle *r);".PPUnknown Function .PP.BR "void _XmConfigureObject(Widget g, Position x, Position y, Dimension width, Dimension height, Dimension border_width);".PP_XmConfigureObject is a wrapper around.BR XtConfigureWidget (3)which insulates a widget writer from the burden of checking whether an objectis 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..PP.BR "void _XmDestroyFocusData(XmFocusData focusData);".PPUnknown Function .PP.BR "void _XmDispatchGadgetInput(Widget g, XEvent *event, Mask mask);".PPUnknown Function .PP.BR "void _XmFocusModelChanged(Widget wid, XtPointer client_data, XtPointer call_data);".PPUnknown Function .PP.BR "void _XmForegroundColorDefault(Widget widget, int offset, XrmValue *value);".PPUnknown Function .PP.BR "void _XmGetDefaultThresholdsForScreen(Widget widget, int offset, XrmValue *value);".PPUnknown Function .PP.BR "void _XmHighlightColorDefault(Widget widget, int offset, XrmValue *value);".PPUnknown Function