書式

void XmbDrawImageString(display, d, font_set, gc, x, y, string, num_bytes)

      Display *display;

      Drawable d;

      XFontSet font_set;

      GC gc;

      int x, y;

      char *string;

      int num_bytes;

void XwcDrawImageString(display, d, font_set, gc, x, y, string, num_wchars)

      Display *display;

      Drawable d;

      XFontSet font_set;

      GC gc;

      int x, y;

      wchar_t *string;

      int num_wchars;

void Xutf8DrawImageString(display, d, font_set, gc, x, y, string, num_bytes)

      Display *display;

      Drawable d;

      XFontSet font_set;

      GC gc;

      int x, y;

      char *string;

      int num_bytes;

引き数

d

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

display

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

font_set

フォントセットを指定する。

gc

GC を指定する。

num_bytes

引き数 string のバイト数を指定する。

num_wchars

引き数 string の文字数を指定する。

string

文字列を指定する。

x

y

x, y 座標を指定する。

説明

関数 XmbDrawImageString, XwcDrawImageString, Xutf8DrawImageString は GC に定義されている背景色で描画先の矩形領域を塗りつぶした後、前景色 でテキストを描画する。塗りつぶされる矩形領域の大きさは、同一の XFontSet とテキストに対して関数 XmbTextExtents あるいは XwcTextExtents, Xutf8TextExtents が overall_logical_return に返す値である。 XFontSet 内に存在しない文字集合がある場合、これに該当するそれぞれの文字は XCreateFontSet が返すデフォルト文字列を用いて描画される。 不正なコード点の文字に対する挙動は未定義である。

関数 Xutf8DrawImageString は XFree86 4.0.2 から導入された XFree86 独自の拡張である。この関数が あるかどうかはマクロ X_HAVE_UTF8_STRING で判定できる。