名称

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 参照）の配列を返します。 パターン文字列はどんな文字でも含むことができますが、 アスタリスク (∗) は複数の文字のためのワイルドカードであり、 疑問符 (?) は 1 個の文字のためのワイルドカードです。 パターンの文字列がホストポータブル文字コード (Host Portable Character Encoding) に無い場合は、 結果は、インプリメンテーションにより異なります。 大文字、小文字は両方使用できます。 返された各文字列は、ナルで終わります。 サーバが返すデータが、ラテンポータブル文字コード (Latin Porable Character Encoding) にある場合は、 返される文字列は、ホストポータブル文字コードになります。 それ以外の場合の結果は、インプリメンテーションにより異なります。 一致するフォント名がない場合は、 XListFonts は、ナルを返します。 クライアントは、この結果で終了した場合、 XFreeFontNames をコールし、メモリを解放しなければなりません。 XFreeFontNames 関数は、 XListFonts または XListFontsWithInfo で返される配列と文字列を解放します。 XListFontsWithInfo 関数は、指定されたパターンと一致するフォント名のリストおよび対応する フォント情報を返します。 名前リストは、maxnames で指定されたサイズに制限されます。 各フォントについて返される情報は、1 文字あたりの測定基準が返されない ことを除き、 XLoadQueryFont が返す情報と同じです。 パターン文字列はどんな文字でも含むことができますが、 アスタリスク (∗) は複数の文字のためのワイルドカードであり、 疑問符 (?) は 1 個の文字のためのワイルドカードです。 パターンの文字列がホストポータブル文字コード (Host Portable Character Encoding) に無い場合は、 結果は、インプリメンテーションにより異なります。 大文字、小文字は両方使用できます。 返された各文字列は、ナルで終わります。 サーバが返すデータが、ラテンポータブル文字コード (Latin Porable Character Encoding) にある場合は、 返される文字列は、ホストポータブル文字コードになります。 それ以外の場合の結果は、インプリメンテーションにより異なります。 一致するフォント名がない場合、 XListFontsWithInfo はナルを返します。 割り当てられた名前配列のみを解放するには、 クライアントは XFreeFontNames をコールしなければなりません。 名前配列とフォント情報配列の両方、あるいは、 フォント情報配列のみを開放するには、 クライアントは XFreeFont をコールしなければなりません。 XFreeFontInfo 関数は、フォント情報配列を解放します。 フォントをクローズしないで XFontStruct 構造体を解放するには、引数 names に NULL を指定します。

関連事項

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

NEWS-OSRelease 4.2.1R