XmeClearBorder(3X) UNIX System V XmeClearBorder(3X)
NAME
XmeClearBorder - Clears the window decorations that border a
given widget
SYNOPSIS
#include <Xm/DrawP.h>
void XmeClearBorder(
Display *display,
Window window,
Position x,
Position y,
Dimension width,
Dimension height,
Dimension thickness);
VERSION
This page documents Motif 2.1.
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:
⊕ Set x and y to 0.
⊕ Set width and height to the width and height of
window.
⊕ Set thickness to the highlight thickness. (If you are
subclassing a primitive widget, then the highlight
thickness is stored in the field
primitive.highlightthickness.)
The widget's shadows lie within the border highlights. When
calling XmeClearBorder to clear the shadows, your widget
should do the following:
⊕ Set x and y to the highlight thickness.
⊕ Set width so that it equals the width of the window
minus twice the highlight thickness.
⊕ Set height so that it equals the height of the window
minus twice the highlight thickness.
⊕ Set thickness to the shadow thickness of the widget.
(If you are subclassing a primitive widget, the shadow
Page 1 (printed 1/22/99)
XmeClearBorder(3X) UNIX System V XmeClearBorder(3X)
thickness is stored in the field
primitive.shadowthickness.)
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).
Page 2 (printed 1/22/99)