[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide

XmeClearBorder

Clears the window decorations that border a given widget

Format

#include <Xm/DrawP.h>
void XmeClearBorderDisplay
*displayWindow windowPosition
xPosition yDimension
widthDimension heightDimension
thickness

DESCRIPTION

XmeClearBorder clears the border highlight and/or shadows bordering a rectangular widget. To clear these window decorations, XmeClearBorder paints them in the widget's background color.

The border highlight surrounds the perimeter of a widget. When calling XmeClearBorder to clear the border highlight, your widget should do the following:

  1. Set x and y to 0.

  2. Set width and height to the width and height of window.

  3. Set thickness to the highlight thickness. (If you are subclassing a primitive widget, then the highlight thickness is stored in the field primitive.highlight_thickness.)

    The widget's shadows lie within the border highlights. When calling XmeClearBorder to clear the shadows, your widget should do the following:

    1. Set x and y to the highlight thickness.

    2. Set width so that it equals the width of the window minus twice the highlight thickness.

    3. Set height so that it equals the height of the window minus twice the highlight thickness.

    4. Set thickness to the shadow thickness of the widget. (If you are subclassing a primitive widget, the shadow thickness is stored in the field primitive.shadow_thickness.)

      display
      Specifies the display on which window is rendered.

      window
      Specifies the window whose decorations are to be erased.

      x
      Specifies the x-coordinate in pixels of the left edge of whatever decoration is to be cleared.

      y
      Specifies the y-coordinate in pixels of the top edge of whatever decoration is to be cleared.

      width
      Specifies the width in pixels of the top edge of whatever decoration is to be cleared.

      height
      Specifies the height in pixels of the left edge of whatever decoration is to be cleared.

      thickness
      Specifies the thickness in pixels of whatever decoration is to be cleared.

      RELATED

      XmeDrawShadows(3) and XmeDrawHighlight(3).

      5. [ Previous | Next | Contents | Glossary | Home | Search ]