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 はゼロとみなされる。

どちらの関数も以下のGCコンポーネントを使用する。 function, plane-mask, fill-style, font, subwindow-mode, clip-x-origin, clip-y-origin, and clip-mask. They also use these GC mode-dependent components: 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