XSetFontPath

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.3
Index xjman/web INDEX

名前

XSetFontPath, XGetFontPath, XFreeFontPath - フォントのサーチパスの設定、取得、解放

書式

XSetFontPath(display, directories, ndirs)

      Display *display;

      char **directories;

      int ndirs;

char **XGetFontPath(display, npaths_return)

Display *display;

int *npaths_return;

XFreeFontPath(list)

char **list;

引き数

directories: フォントを探すために使うディレクトリパスを指定する。空のリストをパスとして設定すると、X サーバに設定されたデフォルトのパスが復元される。
display: X サーバへの接続を指定する。
list: 解放する文字列の配列を指定する。
ndirs: パスに含まれるディレクトリの数を指定する。
npaths_return: フォントパスの配列内の文字列の数が返される。

説明

関数 XSetFontPath はフォントを探すためのディレクトリ検索パスを定義する。検索パスは X サーバごとに 1 つずつしかなく、クライアントは検索パスを持たない。エンコーディングと文字列の解釈は実装依存であるが、一般的には順序リストとしてディレクトリかフォントサーバを指定する。 X サーバはフォント情報を内部的にキャッシングすることが認められている。例えば、1 つのファイルからフォント全体をキャッシュし、それより後にそのフォントをオープンしたときには元のファイルが変更されたかどうかのチェックを行わなくてもよい。しかしフォントパスが変更されれば、X サーバが現在キャッシュしているフォント情報はすべてフラッシュされることが保証されている。ただし、その時点でリソース ID が明示的に割り当てられているフォントはフラッシュされない。このリクエストで起こるエラーの意味は実装依存である。

XSetFontPath はエラー BadValue を起こすことがある。

関数 XGetFontPath は検索パスを含む文字列の配列を割り当てて返す。この文字列の内容は実装依存であり、クライアントアプリケーションによって解釈されることは想定されていない。文字列が必要なくなったときには、 XFreeFontPath を呼び出してフォントパスのデータを解放すること。

関数 XFreeFontPath は XGetFontPath が割り当てたデータを解放する。

返り値

BadValue: 指定された数値の中にリクエストの許容範囲を越えているものがある。引き数に対して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範囲が許される。選択肢として定義されている引き数はこのエラーを起こすことがある。

This document was created by man2html, using the manual pages.
Time: 15:56:00 GMT, February 12, 2001

XSetFontPath

名前

書式

引き数

説明

返り値

関連項目

Index