XDrawString()XDrawString()Name
XDrawString – draw an 8-bit text string, foreground only.
Synopsis
XDrawString(display, drawable, gc, x, y, string, length)
Display *display;
Drawable drawable;
GC gc;
int x, y;
char *string;
int length;
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 baseline starting
y position for the character, relative to the origin of the
specified drawable.
string Specifies the character string.
length Specifies the number of characters in string.
DescriptionXDrawString() draws the given string into a drawable using the fore‐
ground only to draw set bits in the font. It does not affect any other
pixels in the bounding box for each character.
The y coordinate defines the baseline row of pixels while the x coordi‐
nate is the point from which lbearing, rbearing, and width are mea‐
sured.
XDrawString() uses these graphics context components: function,
plane_mask, fill_style, font, subwindow_mode, clip_x_origin,
clip_y_origin, and clip_mask. This function also uses these graphics
context mode-dependent components: foreground, background, tile, stip‐
ple, ts_x_origin, and ts_y_origin. Each character image, as defined by
the font in gc, is treated as an additional mask for a fill operation
on the drawable.
For more information, see Volume One, Chapter 6, Drawing Graphics and
Text, and Chapter 5, The Graphics Context.
Errors
BadDrawable
BadGC
BadMatch
See AlsoXDrawImageString(), XDrawImageString16(), XDrawString16(), XDrawText(),
XDrawText16(), XQueryTextExtents(), XQueryTextExtents16(), XTextEx‐
tents(), XTextExtents16(), XTextWidth(), XTextWidth16().
Xlib - Text XDrawString()