名称

XDrawImageString, XDrawImageString16 − イメージテキストを描く

形式

XDrawImageString(display, d, gc, x, y, string, length)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      char ∗string;
      int length; XDrawImageString16(display, d, gc, x, y, string, length)
      Display ∗display;
      Drawable d;
      GC gc;
      int x, y;
      XChar2b ∗string;
      int length;

引数

ddrawable を指定します。

displayX サーバへのコネクションを指定します。

gcGC (Graphic Context) を指定します。

lengthstring 引数の文字数を指定します。

string文字列を指定します。

x

y指定された drawable の原点に相対する x − y 座標を指定し、最初の文字の原点を定義します。

解説

XDrawImageString16 関数は、2バイトまたは 16 ビットの文字を使用するということを除き、 XDrawImageString と同じです。 両方の関数とも、デスティネーションの GC のフォアグラウンド およびバックグラウンドピクセルの両方を使用します。 第一の影響は、デスティネーション矩形に GC で定義された バックグラウンドピクセルをフィルし、 テキストをフォアグラウンドピクセルでペイントします。 フィルされた矩形の上部左側コーナは、次のとおりです。

[x, y − font-ascent]

幅は以下のとおりです。

overall-width

高さは以下のとおりです。

font-ascent + font-descent

全幅、フォントの ascent および descent は、 gc と string を使用して XQueryTextExtents で返されるとおりです。 GC で定義された関数とフィルスタイルは、 これらの関数 (XDrawImageString16) については無視されます。 有効な関数は GXcopy であり、有効なフィルスタイルは、 FillSolid です。 2バイトの行列索引で定義され、 XDrawImageString とともに使用されるフォントについて、各バイトは、 byte1 が 0 の byte2 として使用されます。 両方の関数は、以下の GC 構成要素を使用します。 つまり、plane-mask、foreground、background、font、subwindow-mode、 clip-x-origin、clip-y-origin、clip-mask を使用します。 XDrawImageString と XDrawImageString16 は、 BadDrawable、 BadGC および BadMatch エラーを生じることがあります。

診断

BadDrawable
Drawable 引数の値が、定義された。Window または Pixmap を指さない。

BadGC GContext 引数の値が、定義された GContext を指さない。

BadMatch InputOnly ウィンドウが、Drawable として使用された。

BadMatch ある引数またはひと組の引数の型と範囲は正しいが、 リクエストにより要求されたその他のなにかが一致しない。

関連事項

XDrawString(3X11), XDrawText(3X11), XLoadFont(3X11), XTextExtents(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.1C