home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / X / mit / lib / Xt / Geometry.c < prev    next >
Encoding:
C/C++ Source or Header  |  1993-07-21  |  15.8 KB  |  550 lines
  1. /* $XConsortium: Geometry.c,v 1.56 93/05/13 16:04:14 kaleb Exp $ */
  2.  
  3. /***********************************************************
  4. Copyright 1987, 1988 by Digital Equipment Corporation, Maynard, Massachusetts,
  5. and the Massachusetts Institute of Technology, Cambridge, Massachusetts.
  6.  
  7.                         All Rights Reserved
  8.  
  9. Permission to use, copy, modify, and distribute this software and its 
  10. documentation for any purpose and without fee is hereby granted, 
  11. provided that the above copyright notice appear in all copies and that
  12. both that copyright notice and this permission notice appear in 
  13. supporting documentation, and that the names of Digital or MIT not be
  14. used in advertising or publicity pertaining to distribution of the
  15. software without specific, written prior permission.  
  16.  
  17. DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  18. ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  19. DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  20. ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  21. WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  22. ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  23. SOFTWARE.
  24.  
  25. ******************************************************************/
  26.  
  27. #include "IntrinsicI.h"
  28. #include "ShellP.h"
  29.  
  30. static void ClearRectObjAreas(r, old)
  31.     RectObj r;
  32.     XWindowChanges* old;
  33. {
  34.     Widget pw = _XtWindowedAncestor((Widget)r);
  35.     int bw2;
  36.  
  37.     bw2 = old->border_width << 1;
  38.     XClearArea( XtDisplay(pw), XtWindow(pw),
  39.         old->x, old->y,
  40.         old->width + bw2, old->height + bw2,
  41.         TRUE );
  42.  
  43.     bw2 = r->rectangle.border_width << 1;
  44.     XClearArea( XtDisplay(pw), XtWindow(pw),
  45.         (int)r->rectangle.x, (int)r->rectangle.y,
  46.         (unsigned int)(r->rectangle.width + bw2),
  47.             (unsigned int)(r->rectangle.height + bw2),
  48.         TRUE );
  49. }
  50.  
  51. /*
  52.  * Internal function used by XtMakeGeometryRequest and XtSetValues.
  53.  * Returns more data than the public interface.  Does not convert
  54.  * XtGeometryDone to XtGeometryYes.
  55.  *
  56.  * clear_rect_obj - *** RETURNED ***  
  57.  *            TRUE if the rect obj has been cleared, false otherwise.
  58.  */
  59.  
  60. XtGeometryResult 
  61. _XtMakeGeometryRequest (widget, request, reply, clear_rect_obj)
  62.     Widget widget;
  63.     XtWidgetGeometry *request, *reply;
  64.     Boolean * clear_rect_obj;
  65. {
  66.     XtWidgetGeometry    junk;
  67.     XtGeometryHandler manager;
  68.     XtGeometryResult returnCode;
  69.     Widget parent = widget->core.parent;
  70.     XtGeometryMask    changeMask;
  71.     Boolean managed, parentRealized, rgm = False;
  72.     XWindowChanges changes;
  73.  
  74.     *clear_rect_obj = FALSE;
  75.  
  76.     if (XtIsShell(widget)) {
  77.     ShellClassExtension ext;
  78.     for (ext = (ShellClassExtension)((ShellWidgetClass)XtClass(widget))
  79.            ->shell_class.extension;
  80.          ext != NULL && ext->record_type != NULLQUARK;
  81.          ext = (ShellClassExtension)ext->next_extension);
  82.  
  83.     if (ext != NULL) {
  84.         if (  ext->version == XtShellExtensionVersion
  85.           && ext->record_size == sizeof(ShellClassExtensionRec)) {
  86.         manager = ext->root_geometry_manager;
  87.         rgm = True;
  88.         } else {
  89.         String params[1];
  90.         Cardinal num_params = 1;
  91.         params[0] = XtClass(widget)->core_class.class_name;
  92.         XtAppErrorMsg(XtWidgetToApplicationContext(widget),
  93.              "invalidExtension", "xtMakeGeometryRequest",
  94.              XtCXtToolkitError,
  95.              "widget class %s has invalid ShellClassExtension record",
  96.              params, &num_params);
  97.         }
  98.     } else {
  99.         XtAppErrorMsg(XtWidgetToApplicationContext(widget),
  100.               "internalError", "xtMakeGeometryRequest",
  101.               XtCXtToolkitError,
  102.               "internal error; ShellClassExtension is NULL",
  103.               NULL, NULL);
  104.     }
  105.     managed = True;
  106.     parentRealized = TRUE;
  107.     } else if (parent == NULL) {
  108.     XtAppErrorMsg(XtWidgetToApplicationContext(widget),
  109.               "invalidParent","xtMakeGeometryRequest",XtCXtToolkitError,
  110.               "non-shell has no parent in XtMakeGeometryRequest",
  111.               (String *)NULL, (Cardinal *)NULL);
  112.     } else /* not shell */ {
  113.     managed = XtIsManaged(widget);
  114.  
  115.     if (XtIsComposite(parent)) {
  116.         parentRealized = XtIsRealized(parent);
  117.         manager = ((CompositeWidgetClass) (parent->core.widget_class))
  118.             ->composite_class.geometry_manager;
  119.     } else if (managed) {
  120.         /* Should never happen - XtManageChildren should have checked */
  121.         XtAppErrorMsg(XtWidgetToApplicationContext(widget),
  122.               "invalidParent", "xtMakeGeometryRequest",
  123.               XtCXtToolkitError,
  124.               "XtMakeGeometryRequest - parent not composite",
  125.               (String *)NULL, (Cardinal *)NULL);
  126.     } else {
  127.         /* no need to waste time checking if parent is actually realized
  128.          * at this point; since the child is unmanaged we need to perform
  129.          * the configure iff the child is realized, so we dummy the
  130.          * parentRealized checks below.
  131.          */
  132.         parentRealized = TRUE;
  133.     }
  134.     }
  135.  
  136.     if (managed && manager == (XtGeometryHandler) NULL) {
  137.     XtErrorMsg("invalidGeometryManager","xtMakeGeometryRequest",
  138.                  XtCXtToolkitError,
  139.                  "XtMakeGeometryRequest - parent has no geometry manager",
  140.                   (String *)NULL, (Cardinal *)NULL);
  141.     }
  142.  
  143.     if (widget->core.being_destroyed) return XtGeometryNo;
  144.  
  145.     /* see if requesting anything to change */
  146.     changeMask = 0;
  147.     if (request->request_mode & CWStackMode
  148.     && request->stack_mode != XtSMDontChange) {
  149.         changeMask |= CWStackMode;
  150.         if (request->request_mode & CWSibling) {
  151.         XtCheckSubclass(request->sibling, rectObjClass,
  152.                 "XtMakeGeometryRequest");
  153.         changeMask |= CWSibling;
  154.         }
  155.     }
  156.     if (request->request_mode & CWX
  157.     && widget->core.x != request->x) changeMask |= CWX;
  158.     if (request->request_mode & CWY
  159.     && widget->core.y != request->y) changeMask |= CWY;
  160.     if (request->request_mode & CWWidth
  161.     && widget->core.width != request->width) changeMask |= CWWidth;
  162.     if (request->request_mode & CWHeight
  163.     && widget->core.height != request->height) changeMask |= CWHeight;
  164.     if (request->request_mode & CWBorderWidth
  165.     && widget->core.border_width != request->border_width)
  166.     changeMask |= CWBorderWidth;
  167.     if (! changeMask) return XtGeometryYes;
  168.     changeMask |= (request->request_mode & XtCWQueryOnly);
  169.  
  170.     if ( !(changeMask & XtCWQueryOnly) && XtIsRealized(widget) ) {
  171.     /* keep record of the current geometry so we know what's changed */
  172.     changes.x = widget->core.x ;
  173.     changes.y = widget->core.y ;
  174.     changes.width = widget->core.width ;
  175.     changes.height = widget->core.height ;
  176.     changes.border_width = widget->core.border_width ;
  177.     }
  178.  
  179.     if (!managed || !parentRealized) {
  180.     /* Don't get parent's manager involved--assume the answer is yes */
  181.     if (changeMask & XtCWQueryOnly) {
  182.         /* He was just asking, don't change anything, just tell him yes */
  183.         return XtGeometryYes;
  184.     } else {
  185.         /* copy values from request to widget */
  186.         if (request->request_mode & CWX)
  187.         widget->core.x = request->x;
  188.         if (request->request_mode & CWY)
  189.         widget->core.y = request->y;
  190.         if (request->request_mode & CWWidth)
  191.         widget->core.width = request->width;
  192.         if (request->request_mode & CWHeight)
  193.         widget->core.height = request->height;
  194.         if (request->request_mode & CWBorderWidth)
  195.         widget->core.border_width = request->border_width;
  196.         if (!parentRealized) return XtGeometryYes;
  197.         else returnCode = XtGeometryYes;
  198.     }
  199.     } else {
  200.     /* go ask the widget's geometry manager */
  201.     if (reply == (XtWidgetGeometry *) NULL) {
  202.         returnCode = (*manager)(widget, request, &junk);
  203.     } else {
  204.         returnCode = (*manager)(widget, request, reply);
  205.     }
  206.     }
  207.  
  208.     /*
  209.      * If Unrealized, not a XtGeometryYes, or a query-only then we are done.
  210.      */
  211.  
  212.     if ((returnCode != XtGeometryYes) || 
  213.     (changeMask & XtCWQueryOnly) || !XtIsRealized(widget)) {
  214.  
  215.     return returnCode;
  216.     }
  217.  
  218.     if (XtIsWidget(widget)) {    /* reconfigure the window (if needed) */
  219.  
  220.     if (rgm) return returnCode;
  221.  
  222.     if (changes.x != widget->core.x) {
  223.          changeMask |= CWX;
  224.          changes.x = widget->core.x;
  225.      }
  226.      if (changes.y != widget->core.y) {
  227.          changeMask |= CWY;
  228.          changes.y = widget->core.y;
  229.      }
  230.      if (changes.width != widget->core.width) {
  231.          changeMask |= CWWidth;
  232.          changes.width = widget->core.width;
  233.      }
  234.      if (changes.height != widget->core.height) {
  235.          changeMask |= CWHeight;
  236.          changes.height = widget->core.height;
  237.      }
  238.      if (changes.border_width != widget->core.border_width) {
  239.          changeMask |= CWBorderWidth;
  240.          changes.border_width = widget->core.border_width;
  241.      }
  242.     if (changeMask & CWStackMode) {
  243.         changes.stack_mode = request->stack_mode;
  244.         if (changeMask & CWSibling)
  245.         if (XtIsWidget(request->sibling))
  246.             changes.sibling = XtWindow(request->sibling);
  247.         else
  248.             changeMask &= ~(CWStackMode | CWSibling);
  249.     }
  250.  
  251.     XConfigureWindow(XtDisplay(widget), XtWindow(widget),
  252.              changeMask, &changes);
  253.     }
  254.     else {            /* RectObj child of realized Widget */
  255.     *clear_rect_obj = TRUE;
  256.     ClearRectObjAreas((RectObj)widget, &changes);
  257.     }
  258.  
  259.     return returnCode;
  260. } /* _XtMakeGeometryRequest */
  261.  
  262.  
  263. /* Public routines */
  264.  
  265. XtGeometryResult XtMakeGeometryRequest (widget, request, reply)
  266.     Widget         widget;
  267.     XtWidgetGeometry *request, *reply;
  268. {
  269.     Boolean junk;
  270.     XtGeometryResult returnCode;
  271.  
  272.     returnCode = _XtMakeGeometryRequest(widget, request, reply, &junk);
  273.  
  274.     return ((returnCode == XtGeometryDone) ? XtGeometryYes : returnCode);
  275. }
  276.  
  277. #if NeedFunctionPrototypes
  278. XtGeometryResult XtMakeResizeRequest(
  279.     Widget    widget,
  280.     _XtDimension width,
  281.     _XtDimension height,
  282.     Dimension    *replyWidth,
  283.     Dimension    *replyHeight
  284.     )
  285. #else
  286. XtGeometryResult XtMakeResizeRequest
  287.     (widget, width, height, replyWidth, replyHeight)
  288.     Widget    widget;
  289.     Dimension    width, height;
  290.     Dimension    *replyWidth, *replyHeight;
  291. #endif
  292. {
  293.     XtWidgetGeometry request, reply;
  294.     XtGeometryResult r;
  295.  
  296.     request.request_mode = CWWidth | CWHeight;
  297.     request.width = width;
  298.     request.height = height;
  299.     r = XtMakeGeometryRequest(widget, &request, &reply);
  300.     if (replyWidth != NULL)
  301.     if (r == XtGeometryAlmost && reply.request_mode & CWWidth)
  302.         *replyWidth = reply.width;
  303.     else
  304.         *replyWidth = width;
  305.     if (replyHeight != NULL)
  306.     if (r == XtGeometryAlmost && reply.request_mode & CWHeight)
  307.         *replyHeight = reply.height;
  308.     else
  309.         *replyHeight = height;
  310.     return r;
  311. } /* XtMakeResizeRequest */
  312.  
  313. void XtResizeWindow(w)
  314.     Widget w;
  315. {
  316.     if (XtIsRealized(w)) {
  317.     XWindowChanges changes;
  318.     changes.width = w->core.width;
  319.     changes.height = w->core.height;
  320.     changes.border_width = w->core.border_width;
  321.     XConfigureWindow(XtDisplay(w), XtWindow(w),
  322.         (unsigned) CWWidth | CWHeight | CWBorderWidth, &changes);
  323.     }
  324. } /* XtResizeWindow */
  325.  
  326.  
  327. #if NeedFunctionPrototypes
  328. void XtResizeWidget(
  329.     Widget w,
  330.     _XtDimension width,
  331.     _XtDimension height,
  332.     _XtDimension borderWidth
  333.     )
  334. #else
  335. void XtResizeWidget(w, width, height, borderWidth)
  336.     Widget w;
  337.     Dimension width, height, borderWidth;
  338. #endif
  339. {
  340.     XWindowChanges changes;
  341.     Dimension old_width, old_height, old_borderWidth;
  342.     Cardinal mask = 0;
  343.  
  344.     if ((old_width = w->core.width) != width) {
  345.     changes.width = w->core.width = width;
  346.     mask |= CWWidth;
  347.     }
  348.  
  349.     if ((old_height = w->core.height) != height) {
  350.     changes.height = w->core.height = height;
  351.     mask |= CWHeight;
  352.     }
  353.  
  354.     if ((old_borderWidth = w->core.border_width) != borderWidth) {
  355.     changes.border_width = w->core.border_width = borderWidth;
  356.     mask |= CWBorderWidth;
  357.     }
  358.  
  359.     if (mask != 0) {
  360.     if (XtIsRealized(w)) {
  361.         if (XtIsWidget(w))
  362.         XConfigureWindow(XtDisplay(w), XtWindow(w), mask, &changes);
  363.         else {
  364.         Widget pw = _XtWindowedAncestor(w);
  365.         old_width += (old_borderWidth << 1);
  366.         old_height += (old_borderWidth << 1);
  367.         if ((Dimension)(width + (borderWidth << 1)) > old_width)
  368.             old_width = width + (borderWidth << 1);
  369.         if ((Dimension)(height + (borderWidth << 1)) > old_height)
  370.             old_height = height + (borderWidth << 1);
  371.         XClearArea( XtDisplay(pw), XtWindow(pw),
  372.                 (int)w->core.x, (int)w->core.y,
  373.                 (unsigned int)old_width, (unsigned int)old_height,
  374.                 TRUE );
  375.         }
  376.     }
  377.     if ((mask & (CWWidth | CWHeight)) &&
  378.           XtClass(w)->core_class.resize != (XtWidgetProc) NULL)
  379.         (*(w->core.widget_class->core_class.resize))(w);
  380.     }
  381. } /* XtResizeWidget */
  382.  
  383. #if NeedFunctionPrototypes
  384. void XtConfigureWidget(
  385.     Widget w,
  386.     _XtPosition x,
  387.     _XtPosition y,
  388.     _XtDimension width,
  389.     _XtDimension height,
  390.     _XtDimension borderWidth
  391.     )
  392. #else
  393. void XtConfigureWidget(w, x, y, width, height, borderWidth)
  394.     Widget w;
  395.     Position x, y;
  396.     Dimension width, height, borderWidth;
  397. #endif
  398. {
  399.     XWindowChanges changes, old;
  400.     Cardinal mask = 0;
  401.  
  402.     if ((old.x = w->core.x) != x) {
  403.     changes.x = w->core.x = x;
  404.     mask |= CWX;
  405.     }
  406.  
  407.     if ((old.y = w->core.y) != y) {
  408.     changes.y = w->core.y = y;
  409.     mask |= CWY;
  410.     }
  411.  
  412.     if ((old.width = w->core.width) != width) {
  413.     changes.width = w->core.width = width;
  414.     mask |= CWWidth;
  415.     }
  416.  
  417.     if ((old.height = w->core.height) != height) {
  418.     changes.height = w->core.height = height;
  419.     mask |= CWHeight;
  420.     }
  421.  
  422.     if ((old.border_width = w->core.border_width) != borderWidth) {
  423.     changes.border_width = w->core.border_width = borderWidth;
  424.     mask |= CWBorderWidth;
  425.     }
  426.  
  427.     if (mask != 0) {
  428.     if (XtIsRealized(w)) {
  429.         if (XtIsWidget(w))
  430.         XConfigureWindow(XtDisplay(w), XtWindow(w), mask, &changes);
  431.         else
  432.         ClearRectObjAreas((RectObj)w, &old);
  433.     }
  434.     if ((mask & (CWWidth | CWHeight)) &&
  435.           XtClass(w)->core_class.resize != (XtWidgetProc) NULL)
  436.         (*(w->core.widget_class->core_class.resize))(w);
  437.     }
  438. } /* XtConfigureWidget */
  439.  
  440. #if NeedFunctionPrototypes
  441. void XtMoveWidget(
  442.     Widget w,
  443.     _XtPosition x,
  444.     _XtPosition y
  445.     )
  446. #else
  447. void XtMoveWidget(w, x, y)
  448.     Widget w;
  449.     Position x, y;
  450. #endif
  451. {
  452.     if ((w->core.x != x) || (w->core.y != y)) {
  453.     XWindowChanges old;
  454.     old.x = w->core.x;
  455.     old.y = w->core.y;
  456.     w->core.x = x;
  457.     w->core.y = y;
  458.     if (XtIsRealized(w)) {
  459.         if (XtIsWidget(w))
  460.         XMoveWindow(XtDisplay(w), XtWindow(w), w->core.x, w->core.y);
  461.         else {
  462.         old.width = w->core.width;
  463.         old.height = w->core.height;
  464.         old.border_width = w->core.border_width;
  465.         ClearRectObjAreas((RectObj)w, &old);
  466.         }
  467.         }
  468.     }
  469. } /* XtMoveWidget */
  470.  
  471. #if NeedFunctionPrototypes
  472. void XtTranslateCoords(
  473.     register Widget w,
  474.     _XtPosition x,
  475.     _XtPosition y,
  476.     register Position *rootx,    /* return */
  477.     register Position *rooty    /* return */
  478.     )
  479. #else
  480. void XtTranslateCoords(w, x, y, rootx, rooty)
  481.     register Widget w;
  482.     Position x, y;
  483.     register Position *rootx, *rooty;    /* return */
  484. #endif
  485. {
  486.     Position garbagex, garbagey;
  487.     Widget passed = w;
  488.  
  489.     if (rootx == NULL) rootx = &garbagex;
  490.     if (rooty == NULL) rooty = &garbagey;
  491.  
  492.     *rootx = x;
  493.     *rooty = y;
  494.  
  495.     for (; w != NULL && ! XtIsShell(w); w = w->core.parent) {
  496.     *rootx += w->core.x + w->core.border_width;
  497.     *rooty += w->core.y + w->core.border_width;
  498.     }
  499.  
  500.     if (w == NULL)
  501.         XtAppWarningMsg(XtWidgetToApplicationContext(passed),
  502.         "invalidShell","xtTranslateCoords",XtCXtToolkitError,
  503.                 "Widget has no shell ancestor",
  504.         (String *)NULL, (Cardinal *)NULL);
  505.     else {
  506.     Position x, y;
  507.     extern void _XtShellGetCoordinates();
  508.     _XtShellGetCoordinates( w, &x, &y );
  509.     *rootx += x + w->core.border_width;
  510.     *rooty += y + w->core.border_width;
  511.     }
  512. }
  513.  
  514. XtGeometryResult XtQueryGeometry(widget, intended, reply)
  515.     Widget widget;
  516.     register XtWidgetGeometry *intended; /* parent's changes; may be NULL */
  517.     XtWidgetGeometry *reply;    /* child's preferred geometry; never NULL */
  518. {
  519.     XtWidgetGeometry null_intended;
  520.     XtGeometryHandler query = XtClass(widget)->core_class.query_geometry;
  521.     XtGeometryResult result;
  522.  
  523.     reply->request_mode = 0;
  524.     if (query != NULL) {
  525.     if (intended == NULL) {
  526.         null_intended.request_mode = 0;
  527.         intended = &null_intended;
  528.     }
  529.     result = (*query) (widget, intended, reply);
  530.     }
  531.     else {
  532.     result = XtGeometryYes;
  533.     }
  534.  
  535. #define FillIn(mask, field) \
  536.     if (!(reply->request_mode & mask)) reply->field = widget->core.field;
  537.  
  538.     FillIn(CWX, x);
  539.     FillIn(CWY, y);
  540.     FillIn(CWWidth, width);
  541.     FillIn(CWHeight, height);
  542.     FillIn(CWBorderWidth, border_width);
  543. #undef FillIn
  544.  
  545.     if (!reply->request_mode & CWStackMode) reply->stack_mode =
  546. XtSMDontChange;
  547.  
  548.     return result;
  549.   }
  550.