XFontsOfFontSet(3X11)

名前
XFontsOfFontSet, XBaseFontNameListOfFontSet, XLocaleOfFontSet, XContextDependentDrawing, XContextualDrawing, XDirectionalDependentDrawing - フォントセットの情報を取得

書式
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
    フォント構造体のリストが返される。

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

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

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

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

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

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

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

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

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

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

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

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

関連項目
XCreateFontSet(3X11), XCreateOM(3X11), XCreateOC(3X11), XExtentsOfFontSet(3X11), XFontSetExtents(3X11)
Xlib - C Language X Interface