名称

XListFonts, XFreeFontNames, XListFontsWithInfo, XFreeFontInfo − フォント名および情報を得るかまたは解放する

形式

char ∗∗XListFonts(display, pattern, maxnames, actual_count_return)
      Display ∗display;
      char ∗pattern;
      int maxnames;
      int ∗actual_count_return; XFreeFontNames(list)
      char ∗list[]; char ∗∗XListFontsWithInfo(display, pattern, maxnames, count_return, info_return)
      Display ∗display;
      char ∗pattern;
      int maxnames;
      int ∗count_return;
      XFontStruct ∗∗info_return; XFreeFontInfo(names, free_info, actual_count)
      char ∗∗names;
      XFontStruct ∗free_info;
      int actual_count;

引数

actual_countXListFontsWithInfo で返される一致したフォント名の実際の数を指定します。

actual_count_return
フォント名の実際の数を返します。

count_return一致したフォント名の実際の数を指定します。

displayX サーバへのコネクションを指定します。

info_returnフォント情報を指すポインタを返します。

free_infoXListFontsWithInfo で返されるフォント情報を指すポインタを指定します。

list解放したい文字列の配列を指定します。

maxnames返される最大名前数を指定します。

namesXListFontsWithInfo で返されるフォント名のリストを指定します。

patternワイルドカード文字を含むことのできるナルで終わるパターン文字列を指定します。

解説

XListFonts 関数は、 pattern 引数に渡された文字列と一致するフォント名 （フォントサーチパスで制御される。 XSetFontPath 参照）の配列を返します。 文字列は ISO Latin-1 でなければなりません。 大文字、小文字は両方使用できます。 各文字列は、 ASCII ナルで終わります。 パターン文字列はどんな文字でも含むことができますが、 アスタリスク (∗) は複数の文字のためのワイルドカードであり、 疑問符 (?) は 1 個の文字のためのワイルドカードです。 クライアントは、この結果で終了した場合、 XFreeFontNames をコールし、メモリを解放しなければなりません。 XFreeFontNames 関数は、 XListFonts または XListFontsWithInfo で返される配列と文字列を解放します。 XListFontsWithInfo 関数は、指定されたパターンと一致するフォント名のリストおよび対応する フォント情報を返します。 名前リストは、 maxnames で指定されたサイズに制限されます。 各フォントについて返される情報は、 1 文字あたりの測定基準が返されない ことを除き、 XLoadQueryFont が返す情報と同じです。 パターン文字列はどんな文字でも含むことができますが、 アスタリスク (∗) は複数の文字のためのワイルドカードであり、 疑問符 (?) は 1 個の文字のためのワイルドカードです。 割り当てられた名前配列を解放するには、 クライアントは XFreeFontNames をコールしなければなりません。 また、フォント情報配列を解放するには、 クライアントは XFreeFontInfo をコールしなければなりません。 XFreeFontInfo 関数は、フォント情報配列を解放します。

関連事項

XLoadFont(3X11), XSetFontPath(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3