名称

XmbTextPerCharExtents, XwcTextPerCharExtents − テキスト文字列に関するキャラクタごとの情報を獲得する

形式

Status XmbTextPerCharExtents(font_set, string, num_bytes, ink_array_return,
           logical_array_return, array_size, num_chars_return, overall_return)
      XFontSet font_set;
      char ∗string;
      int num_bytes;
      XRectangle ∗ink_array_return;
      XRectangle ∗logical_array_return;
      int array_size;
      int ∗num_chars_return;
      XRectangle ∗overall_ink_return;
      XRectangle ∗overall_logical_return; Status XwcTextPerCharExtents(font_set, string, num_wchars, ink_array_return,
          logical_array_return, array_size, num_chars_return, overall_return)
      XFontSet font_set;
      wchar_t ∗string;
      int num_wchars;
      XRectangle ∗ink_array_return;
      XRectangle ∗logical_array_return;
      int array_size;
      int ∗num_chars_return;
      XRectangle ∗overall_ink_return;
      XRectangle ∗overall_logical_return;

引数

array_sizeink_array_return および logical_array_return のサイズを 指定します。 呼び出す側は、このサイズの配列で渡さなければならない ことに注意してください。

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

ink_array_return
各キャラクタに関するインク幅を返します。

logical_array_return
各キャラクタに関する論理幅を返します。

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

num_chars_return
文字列引数内のバイト数を返します。

num_wchars文字列引数内の文字数を指定します。

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

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

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

解説

XmbTextPerCharExtents および XwcTextPerCharExtents は、 指定フォントセットに関して ロードされたフォントを使用することで、 指定テキストの各キャラクタのテキスト 幅を返します。 ink_array_return および logical_array_return の有効なそれぞれの要素は有効な キャラクタ描出メトリクスに設定されます。 それは、文字列の描出原点に関連しており、 提供するテキスト文字列内の各キャラクタ に対する一つの XRectangle で、設定された ink_array_return および logical_array_return の要素の数は num_chars_return に返されます。 ink_array_return の各要素は、 対応するキャラクタの描出されたフォアグラウンドカラー に設定されます。 logical_array_return の各要素は、 最小のスペーシングを対応するキャラクタに 関するその他のグラフィカルな特長 へ設定する枠ボックスに設定されます。 その他のグラフィカルな特長は どのような logical_array_return 矩形 に対しても交差してはいけません。 XRectangle は、キャラクタを描く際に使用されるフォントグリフ の数またはキャラクタが描かれる際の方向に かかわらず、そのキャラクタの有効な 描出幅を表すことに注意してください。 複数のキャラクタが一つのキャラクタグリフ にマップした場合、 それらのキャラクタの 全ての XRectangles の幅は同じです。 XFontSet にキャラクタセットがない場合、 使用できない各キャラクタに関するメトリクスは XCreateFontSet によって返されたデフォルト文字列から獲得され、 そのメトリクスが実際に描かれるような テキストを表します。 無効なコードポイントに関する処理は未定議です。 指定テキスト内のキャラクタ数に対して、 array_size が小さすぎた場合、 関数はゼロを返し、 num_chars_return が必要な矩形の数に設定されます。 そうでなければ、 ルーチンはゼロ以外の値を返します。 overall_ink_return または overall_logical_return 引数 が NULL 以外の場合、 XmbTextExtents または XwcTextExtents と同様 XmbTexPerCharExtents および XwcTextPerCharExtents は文字列メトリクスの最大長を overall_ink_return または overall_logical_return に返します。

関連事項

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

NEWS-OSRelease 4.2.1R