XmbTextExtents

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.3
Index xjman/web INDEX
 

名前

XmbTextExtents, XwcTextExtents - テキストの大きさを計算する  

書式

int XmbTextExtents(font_set, string, num_bytes, overall_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_return)

      XFontSet font_set;

      wchar_t *string;

      int num_wchars;

      XRectangle *overall_ink_return;

      XRectangle *overall_logical_return;  

引き数

font_set
フォントセットを指定。
num_bytes
引き数 string のバイト数を指定。
num_wchars
引き数 string の文字数を指定。
overall_ink_return
描画される領域の ディメンジョン を返す。
overall_logical_return
論理的な ディメンジョン を返す。
string
文字列を指定。
 

説明

関数 XmbTextExtentsXwcTextExtents は指定された引き数 overall_ink_return に文字列の画像イメージのバウンディ ングボックスを、overall_logical_return には論理的なバウンディングボッ クスの大きさをセットする。これらはスペーシングに用いられる。 返される値は、 XmbTextEscapementXwcTextEscapement によって与えられる。 これらのメトリクスは文字列の描画の原点からの相対位置で、指定されたフォ ントセットに対して呼び出されたフォントを用いたものである。

引き数 overall_ink_return が NULL でない場合、これには文字列が実際に描画 される範囲のバウンディングボックスがセットされる。 下向きに進まず、水平に描画される Latin 文字に対する 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, and height = 1 となる。

overall_logical_return が NULL でない場合には、これはその文字列に対す る他のグラフィカルフィーチャへの最小スペーシングを与えるバウンディング ボックスがセットされる。 他のグラフィカルフィーチャ(例えばテキストを囲む境界線)は、この長方形と 交差してはならない。

XFontSet に存在しない文字集合がある場合には、それのテキストが実際に描画される際 の寸法を表すように、該当する各文字に対する寸法は XCreateFontSet が返すデフォルト文字列から得る。 不正な文字コードに対する動作は未定義である。  

関連項目

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


 

Index

名前
書式
引き数
説明
関連項目

This document was created by man2html, using the manual pages.
Time: 15:56:15 GMT, February 12, 2001