XInstallColormap(3X11)

名前
XInstallColormap, XUninstallColormap, XListInstalledColormaps - カラーマップの制御

書式
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   スクリーンを決定するためのウィンドウを指定する。

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

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

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

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

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

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

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

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

返り値

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

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

関連項目
XChangeWindowAtrributes(3X11), XCreateColormap(3X11), XCreateWindow(3X11), XFree(3X11)
Xlib - C Language X Interface