XwcDrawImageString(3) 単一のフォントセットを用いてイメージ文字列を描画する

Other Alias

XmbDrawImageString, Xutf8DrawImageString

書式

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

      Display *display;

      Drawable d;

      XFontSet font_set;

      GC gc;

      int xy;

      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 xy;

      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 xy;

      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 で判定できる。