書式

int XFontsOfFontSet(font_set, font_struct_list_return, font_name_list_return)

       XFontSet font_set;

       XFontStruct ***font_struct_list_return;

       char ***font_name_list_return;

char *XBaseFontNameListOfFontSet(font_set)

      XFontSet font_set;

char *XLocaleOfFontSet(font_set)

      XFontSet font_set;

Bool XContextDependentDrawing(font_set)

      XFontSet font_set;

Bool XContextualDrawing(font_set)

      XFontSet font_set;

Bool XDirectionalDependentDrawing(font_set)

      XFontSet font_set;

引き数

font_set

フォントセットを指定。

font_name_list_return

フォント名のリストが返される。

font_struct_list_return

フォント構造体のリストが返される。

説明

関数 XFontsOfFontSet は、与えられたフォントセットに対して XFontStructs とフォント名のリストを返す。これらのリストは1つ以上の要素からなり、Xmb および Xwc 系の関数で用いられる。 XFontStruct 構造体へのポインタのリストは引き数 font_struct_list_return に返される。 フォント名を表す文字列へのポインタのリストは、引き数 font_name_list_return に返される。これらの文字列は NULL で終わり、フォ ントセットのロケールで完全に特定されたフォント名を与える。 font_name_list の順序は font_struct_list の順序と同じである。 XFontStruct 構造体とフォント名の数は、関数の値として返される。

与えられた文字が単一のフォントグリフを使ってイメージ化されることは保証 されないので、文字に対するフォントについての、文字やデフォルト文字列か らのフォントプロパティ、フォント ID、方向ヒントへの マッピングについての規定はない。 Xクライアントは、現在使われている全てのフォントに対してこれらの値を得 るために、 XFontStruct のリストへアクセスできる。

Xlib は XFontSet の生成時にフォントがサーバからロードされていることを保証しない。 Xlib はテキストの描画やテキストのディメンジョンの計算で必要な時だけフォ ントをロードし、フォントデータをキャッシュすることを選択できる。 従って、 XFontStructSet に含まれる XFontStruct 構造体の per_char メトリクスの存在は未定義である。 また、 XFontStruct 構造体の全てのプロパティは STRING エンコーディングであることに注意する こと。

XFontStruct およびフォント名のリストは Xlib が所有しているので、X クライアントはこ れを修正したり解放したりしてはならない。 これらは対応する XFontSet を引き数に XFreeFontSet を呼び出すことによって解放される。 解放されるまでは、この内容が Xlib によって変更されることはない。

関数 XBaseFontNameListOfFontSet は、 XFontSet が生成されたときにクライアントによって与えられた、元のベースフォント名 のリストを返す。 コンマ区切りのフォント名のリストを含む文字列が関数の値として返される。 この文字列は NULL で終わる。 コンマの直前、直後には空白が入っていることがある。

XCreateFontSet が、非 XLFD のベースネームによって指定されたフォントに対するフォントプ ロパティから XLFD 名を得た場合、関数 XBaseFontNameListOfFontSet は非 XLFD ベース名ではなく XLFD 名を返す。

ベースフォント名のリストは Xlib が所有しているので、X クライアントはこ れを変更したり解放してはならない。 これは関連付けられた XFontSet を引き数として XFreeFontSet を呼び出すことで解放される。 解放されるまでは、Xlib がその内容を変更することはない。

関数 XLocaleOfFontSet は、指定した XFontSet にバインドされたロケールの名前を NULL で終わる文字列の形で返す。

返されるロケール名の文字列は Xlib が所有しているので、X クライアントはこ れを変更したり解放してはならない。 この文字列は対応する XFontSet を引き数に XFreeFontSet を呼び出すことによって解放される。 解放されるまでは Xlib がこれを変更することはない。

関数 XContextDependentDrawing は 描画関数が暗黙のテキスト方向性(implicit text directionality)を実装して いる場合か、font_set によるテキスト描画がコンテクスト依存の描画を含む 場合に True を返す。 そうでない場合には False を返す。

関数 XContextualDrawing は、font_set による描画がコンテクスト依存の描画を含む場合に True を返し、 そうでない場合には False を返す。

関数 XDirectionalDependentDrawing は、描画関数が暗黙のテキスト方向性(implicit text directionality)を実装 しているならば True を返し、 そうでなければ False を返す。