名称

XLoadFont, XQueryFont, XLoadQueryFont, XFreeFont, XGetFontProperty, XUnloadFont − フォントをロードまたはアンロードする

形式

Font XLoadFont(display, name)
      Display ∗display;
      char ∗name; XFontStruct ∗XQueryFont(display, font_ID)
      Display ∗display;
      XID font_ID; XFontStruct ∗XLoadQueryFont(display, name)
      Display ∗display;
      char ∗name; XFreeFont(display, font_struct)
      Display ∗display;
      XFontStruct ∗font_struct; Bool XGetFontProperty(font_struct, atom, value_return)
      XFontStruct ∗font_struct;
      Atom atom;
      unsigned long ∗value_return; XUnloadFont(display, font)
      Display ∗display;
      Font font;

引数

atom返したいプロパティのアトムを指定します。

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

fontフォントを指定します。

font_IDフォント ID または GContext ID を指定します。

font_structフォントに関する記憶領域を指定します。

gcGC を指定します。

nameナルで終わる文字列であるフォント名を指定します。

value_returnフォントプロパティの値を返します。

解説

XLoadFont 関数は指定されたフォントをロードし、対応するフォント ID を返します。 名前は、 ISO Latin-1 のコード化をしなればなりません。 大文字、小文字は両方使用できます。 指定されたフォントのロード時に XLoadFont が失敗すると、 BadName エラーが生じます。 フォントは特定のスクリーンと対応せず、 GC の構成要素としてストアできます。 フォントが必要なくなれば、 XUnloadFont をコールします。 .PN XLoadFont は、 BadAlloc および BadName エラーを生じることがあります。 XQueryFont 関数は、フォントと対応する情報を含む XFontStruct 構造体を指すポインタを返します。 フォントまたは GC にストアされたフォントを問合わせることができます。 XFontStruct 構造体にストアされたフォント ID は GContext ID であり、他の関数でこの ID を使用する場合に注意しなければ なりません（ XGContextFromGC を参照してください）。 このデータを解放するには、 XFreeFontInfo を使用します。 .PN XLoadQueryFont は、 BadAlloc エラーを生じることがあります。 XLoadQueryFont 関数は、フォントをアクセスするための最も一般的な手段です。 XLoadQueryFont は、指定されたフォントをオープン（ロード）し、該当する XFontStruct 構造体を指すポインタを返します。 フォントが存在しなければ、 XLoadQueryFont は NULL を返します。 XFreeFont 関数は、フォントリソース ID と指定されたフォント間の結合を削除し、 XFontStruct 構造体を解放します。 フォントそれ自体は、他のいかなるリソースもこれを参照していなければ、 解放されます。 データとフォントを再び参照してはなりません。 .PN XFreeFont は、 BadFont エラーを生じることがあります。 このプロパティのアトムが与えられると、 XGetFontProperty 関数は、指定されたフォントプロパティの値を返します。また、 XGetFontProperty は、プロパティが定義されなければ False、 定義された場合 True を返します。 フォントプロパティについては、定義済みのアトムの集合があります。 これは <X11/Xatom.h> にあります。 この集合は、フォントと対応する標準プロパティを含んでいます。 保証はしませんが、多くの場合定義済みのフォントプロパティがあります。 XUnloadFont 関数は、フォントリソース ID と指定されたフォント間の結合を削除します。 フォントそれ自体は、他のいかなるリソースもこれを参照していなければ、 解放されます。 フォントは、再び参照してはなりません。 .PN XUnloadFont は、 BadFont エラーを生じることがあります。

診断

BadAlloc サーバが、要求されたリソースまたはサーバメモリの割当てに失敗した。

BadFont Font または GContext 引数の値が定義された Font を指さない。

BadName 指定された名前のフォントまたはカラーが存在しない。

関連事項

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

NEWS-OSRelease 3.3