名前¶

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バイトの行列形式のインデックスで定義され、 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

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

関連項目¶

XDrawImageString(3X11), XDrawText(3X11), XLoadFont(3X11) Xlib - C Language X Interface