名称

XmbTextExtents, XwcTextExtents − テキストの領域を求める

形式

int XmbTextExtents(font_set, string, num_bytes, overall_ink_return,overall_logical_return)
      XFontSet font_set;
      char ∗string;
      int num_bytes;
      XRectangle ∗overall_ink_return;
      XRectangle ∗overall_logical_return; int XwcTextExtents(font_set, string, num_wchars, overall_int_return,overall_logical_return)
      XFontSet font_set;
      wchar_t ∗string;
      int num_wchars;
      XRectangle ∗overall_ink_return;
      XRectangle ∗overall_logical_return;

引数

font_setフォントセットを指定します。

num_bytes文字列引数のバイト数を指定します。

num_wchars文字列引数のキャラクタ数を指定します。

overall_ink_return
全体のインク幅を返します。

overall_logical_return
全体の論理幅を返します。

stringキャラクタ文字列を指定します。

解説

XmbTextExtents および XwcTextExtents 関数は指定の overall_ink_return および overall_logical_return 引数に それぞれ文字列イメージの全体の枠ボックス およびスペーシングのための論理的外枠ボックスを設定します。 XmbTextEscapement または XwcTextEscapement にて返された値を返します。 指定フォントセットに対してロード されたフォントを使用することで、 これらの長さは文字列の描く原点に関連します。 overall_ink_return 引数が NULL 以外の場合、 文字列のキャラクタインク の枠ボックスに設定されます。 水平方向に描かれるラテン系の文字に対する overall_ink_return は 完全にベースラインの 上にあります。つまり、 overall_ink_return.height <= −overall_ink_return.y です。 カーニングをもたない文字列に対しての overall_ink_return は原点の右側にぴったりと設定されます。 つまり、 overall_ink_return.x >= 0 となります。 原点において、ひとつのピクセルから 構成される文字の場合、 overall_ink_return フィールドは y = 0, x = 0, width = 1, height = 1 と設定します。 overall_logical_return 引数が NULL 以外の場合、 最小のスペーシングを 文字列に対するその他のグラフィカルな特長 に設定する枠ボックスに設定されます。 その他のグラフィカルな特長、 例えばテキストを囲む境界はこの矩形に 交差しないようにします。 XFontSet にキャラクタセットがない場合、 長さが実際に描かれる際のテキストを示すように、 XCreateFontSet で返されたデフォルトから 無効なキャラクタごとの長さを取ります。 無効なコードの動作は、定義されていません。

関連事項

XmbTextEscapement(3X11), XmbTextPerCharExtents(3X11) Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R