名称

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 を使用します。 .PN XDrawImageString と .PN XDrawImageString16 は、 BadDrawable、 BadGC および BadMatch エラーを生じることがあります。

診断

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

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

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

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

関連事項

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

NEWS-OSRelease 3.3