NAME

XDrawRectangle — draw an outline of a rectangle. 

SYNOPSIS

XDrawRectangle(display, drawable, gc, x, y, width, height) Display ∗display;  Drawable drawable;  GC gc;  int x, y;  unsigned int width, height;

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

drawableSpecifies the drawable. 

gcSpecifies the graphics context. 

x

ySpecify the x and y coordinates of the upper-left corner of the rectangle, relative to the drawable’s origin. 

width

heightSpecify the width and height in pixels.  These dimensions define the outline of the rectangle. 

DESCRIPTION

XDrawRectangle() draws the outline of the rectangle by using the x and y coordinates, width and height, and graphics context you specify.  Specifically, XDrawRectangle() uses these graphics context components:  function, plane_mask, line_width, line_style, join_style, fill_style, subwindow_mode, clip_ x_origin, clip_y_origin, and clip_mask.  This function also uses these graphics context mode-dependent components:  foreground, background, tile, stipple, ts_x_origin, ts_y_origin, dash_offset, and dashes. 

For the specified rectangle, no pixel is drawn more than once. 

For more information, see Volume One, Chapter 6, Drawing Graphics and Text, and Chapter 5, The Graphics Context. 

ERRORS

BadDrawable
BadGC
BadMatch

SEE ALSO

XClearArea(), XClearWindow(), XCopyArea(), XCopyPlane(), XDraw, XDrawArc(), XDrawArcs(), XDrawFilled(), XDrawLine(), XDrawLines(), XDrawPoint(), XDrawPoints(), XDrawRectangles(), XDrawSegments(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectangles(). 

Xlib Reference Manual