XDrawString(3X11)

名前
XDrawString, XDrawString16 - テキスト文字列を描画する

書式
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;

引き数

d   ドロウアブルを指定する。

display
    X サーバへの接続を指定する。

gc  GC を指定する。

length
    引き数 stirng 内の文字数を指定する。

string
    文字列を指定する。

x

y   x, y 座標を指定する。 これは指定したドロウアブルの原点からの相対座標であり、 最初の文字の原点を定義する。

説明
GC 内のフォントで定義される各文字はのイメージは、ドロウアブルの 塗りつぶし操作への追加のマスクとして扱われる。 ドロウアブルの書き換えられる部分は、フォントの文字のビットが 1 に設定 されているところだけである。 2バイトの行列形式のインデックスで定義され、 で使われるフォントに対しては、各々のバイトは byte2 として扱われ、byte1 は 0 とみなされる。

どちらの関数も以下の GC コンポーネントを使用する: function, plane-mask, fill-style, font, subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask。 また、どちらの関数もこれらの GC のモードに依存するコンポーネントを 使用する: foreground, background, tile, stipple, tile-stipple-x-origin, tile-stipple-y-origin。

と はエラー を起こすことがある。

返り値

引き数 Drawable の値が、定義されている Window や Pixmap を指していない。

引き数 GContext の値が、定義されている GContext を指していない。

のウィンドウがドロウアブルとして指定された。

引き数や引き数の組の型と範囲は正しいが、そのリクエストが要求する
    他の条件に適合できなかった。

関連項目
XDrawImageString(3X11), XDrawText(3X11), XLoadFont(3X11)
Xlib - C Language X Interface