XDrawString(3) テキスト文字列を描画する

Other Alias

XDrawString16

書式

XDrawString(display, d, gc, x, y, string, length)

      Display *display;

      Drawable d;

      GC gc;

      int xy;

      char *string;

      int length

XDrawString16(display, d, gc, x, y, string, length)

      Display *display;

      Drawable d;

      GC gc;

      int xy;

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