XDrawRectangle() XDrawRectangle()
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
display Specifies a connection to an X server; returned from XOpenDisplay().
drawable Specifies the drawable.
gc Specifies the graphics context.
x Specify the x and y coordinates of the upper-left corner of the rectangle, relative to the drawable's origin.
y
width Specify the width and height in pixels. These dimensions define the outline of the rectangle.
height
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(), XDraw-
Point(), XDrawPoints(), XDrawRectangles(), XDrawSegments(), XFillArc(), XFillArcs(), XFillPolygon(), XFillRectangle(), XFillRectangles().
Xlib - Drawing Primitives XDrawRectangle()
