書式

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バイトの行列形式のインデックスで定義され、 XDrawString16 で使われるフォントに対しては、各々のバイトは 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。

XDrawString と はエラー BadDrawable, BadGC, BadMatch を起こすことがある。

返り値

BadDrawable

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

BadGC

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

BadMatch

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

BadMatch

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