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