NAME

XDrawString, XDrawString16 − draw text characters

SYNTAX

XDrawString(display, d, gc, x, y, string, length)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      char ∗string;
      int length;

XDrawString16(display, d, gc, x, y, string, length)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      XChar2b ∗string;
      int length;

ARGUMENTS

dSpecifies the drawable. 

displaySpecifies the connection to the X server. 

gcSpecifies the graphics context. 

lengthSpecifies the number of characters in the string argument. 

stringSpecifies the character string. 

x

ySpecify the x and y coordinates. 

DESCRIPTION

The XDrawString and XDrawString16 functions draw 8-bit and 16-bit text characters in the specified drawable. .PN XDrawString and .PN XDrawString16 can generate BadDrawable, BadFont, BadGC, and BadMatch errors.

DIAGNOSTICS

BadDrawable
A value for a Drawable argument does not name a defined Window or Pixmap.

BadGC A value for a GContext argument does not name a defined GContext. 

BadMatch An InputOnly window is used as a Drawable.

BadMatch Some argument or pair of arguments has the correct type and range but fails to match in some other way required by the request. 

SEE ALSO

XDrawImageString(3X), XDrawText(3X)
Xlib − C Language X Interface

1 March 1988