書式

XInstallColormap(display, colormap)

      Display *display;

      Colormap colormap;

XUninstallColormap(display, colormap)

      Display *display;

      Colormap colormap;

Colormap *XListInstalledColormaps(display, w, num_return)

      Display *display;

      Window w;

      int *num_return;

引き数

colormap

カラーマップを指定する。

display

X サーバへの接続を指定する。

num_return

現在インストールされているカラーマップの数が返される。

w

スクリーンを決定するためのウィンドウを指定する。

説明

関数 XInstallColormap は、指定したカラーマップをカラーマップに対応するスクリーンに インストールする。 このカラーマップに関連する全てのウィンドウは即座に正しい色で表示される ようになる。 ウィンドウとカラーマップの対応づけは、ウィンドウを XCreateWindow, XCreateSimpleWindow, XChangeWindowAttributes, XSetWindowColormap で作った時に行われる。

指定したカラーマップが既にインストールされているカラーマップでない場合、 X サーバはこのカラーマップを持っているウィンドウそれぞれに対して ColormapNotify イベントを生成する。 さらに XInstallColormap を呼んだ結果としてインストールされている他の全てのカラーマップについて、 X サーバはこのカラーマップを持っているそれぞれのウィンドウにおいて ColormapNotify イベントを生成する。

XInstallColormap はエラー BadColor を起こすことがある。

関数 XUninstallColormap は指定したカラーマップをスクリーンの必須のリストから取り除く。 その結果、指定したカラーマップはアンインストールされ、X サーバは追加の カラーマップを暗黙の内にインストールまたはアンインストールする。 どのカラーマップがインストールあるいはアンインストールされるのかは、 必須のリストはインストールされたままでなければならない点を除き、サーバ に依存する。

指定したカラーマップがアンインストールされた場合、 X サーバはそのカラーマップを持っているウィンドウ全てに対して ColormapNotify イベントを生成する。 さらに、 XUninstallColormap の結果としてインストールあるいはアンインストールされた他の全ての カラーマップについて、X サーバはそのカラーマップを持っている ウィンドウにおいて ColormapNotify イベントを生成する。

XUninstallColormap はエラー BadColor を起こすことがある。

XListInstalledColormaps は指定したウィンドウのスクリーンについて、現在インストールされている カラーマップのリストを返す。 リスト中のカラーマップの順序は重要でなく、必須のリストの明示的な指示も 行われない。 割り当てられたリストが不要になった場合には、 XFree を使って解放すること。

XListInstalledColormaps はエラー BadWindow を起こすことがある。

返り値

BadColor

引き数 Colormap の値が、定義されている Colormap を指していない。

BadWindow

引き数 Window の値が、定義されている Window を指していない。