名称

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カラーマップを指定します。

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

num_return現在インストールされているカラーマップの数を返します。

wスクリーンを判断するウィンドウを指定します。

解説

関数は、対応するスクリーンに指定されたカラーマップをインストールします。 このカラーマップと対応するすべてのウィンドウは、ただちに実際のカラーで 表示されます。 XCreateWindow、 XCreateSimpleWindow、 XChangeWindowAttributes または XSetWindowColormap をコールすることで生成されたウィンドウはこのカラーマップと関連しています。 指定されたカラーマップがまだインストールされたカラーマップでなければ、 X サーバは、そのカラーマップをもつ各ウィンドウで ColormapNotify イベントを発生します。 さらに、 XInstallColormap のコールの結果としてインストールされる他の各カラーマップについて、 X サーバは、そのカラーマップをもつ各ウィンドウで ColormapNotify を生じます。 XInstallColormap は、 BadColor エラーを生じることがあります。 XUninstallColormap 関数は、スクリーン用の必要なリストから指定されたカラーマップを 削除します。 結果として、 指定されたカラーマップがはずされたり、 X サーバが暗黙に追加カラーマップをインストールまたはアンインストール することがあります。 どのカラーマップがインストールされるか、またははずされるかは、 サーバ依存です。 ただし、必要なリストは、インストールされたままでなければなりません。 指定されたカラーマップがはずされた場合、X サーバはそのカラーマップを もつ各ウィンドウで ColormapNotify イベントを発生します。 さらに、 XUninstallColormap へのコールの結果としてインストールされるかまたははずされる他の 各カラーマップについて、 X サーバは、カラーマップをもつ各ウィンドウで ColormapNotify イベントを発生します。 XUninstallColormap BadColor は、 BadColor エラーを生じることがあります。 XListInstalledColormaps 関数は、指定されたウィンドウのスクリーンの現在インストールされている カラーマップのリストを返します。 リスト中のカラーマップの順序は重要ではなく、 要求されたリストも明示的に表示されません。 割り当てられたリストがもはや必要なくなった場合、 XFree を用いて解放します。 XListInstalledColormaps は、 BadWindow エラーを生じることがあります。

診断

BadColor Colormap 引数の値が定義された Colormap を指さない。

BadWindow
Window 引数の値が定義された Window を指さない。

関連事項

XChangeWindowAtrributes(3X11), XCreateColormap(3X11), XCreateWindow(3X11), XFree(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R