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