名称

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;

引数

ddrawable を指定します。

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

gcGC を指定します。

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

string文字列を指定します。

x

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

解説

GC のフォントでの定義に基づいて、各文字イメージは、 drawable へのぬりつぶし操作に対して追加されたマスクとして扱われます。 drawable は、フォント文字のビットが１に設定された場所だけが変更されます。 2バイトの行列インデックスで定義され、 XDrawString16 とともに使用されるフォントの場合、各バイトは、 byte1 が 0 の byte2 として使用されます。 両関数は、以下の GC の要素を使用します: function、plane-mask、fill-style、font、subwindow-mode、 clip-x-origin、clip-y-origin および clip-mask。 また、以下の GC モード依存要素を使用します: foreground、background、tile、stipple、 tile-stipple-x-origin および tile-stipple-y-origin。 .PN XDrawString と .PN XDrawString16 が発生するエラーは、 BadDrawable、 BadGC および BadMatch です。

診断

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

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

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

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

関連事項

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

NEWS-OSRelease 3.3