XGetWMColormapWindows(3) ウィンドウの WM_COLORMAP_WINDOWS プロパティの設定・取得を行なう

Other Alias

XSetWMColormapWindows

書式

Status XSetWMColormapWindows(display, w, colormap_windows, count)

      Display *display;

      Window w;

      Window *colormap_windows;

      int count;

Status XGetWMColormapWindows(display, w, colormap_windows_return, count_return)

      Display *display;

      Window w;

      Window **colormap_windows_return;

      int *count_return;

引き数

display
X サーバへの接続を指定する。
colormap_windows
ウィンドウのリストを指定する。
colormap_windows_return
ウィンドウのリストが返される。
count
ウィンドウのリストの数を指定する。
count_return
リスト中のウィンドウの数が返される。
w
ウィンドウを指定する。

説明

関数 XSetWMColormapWindows は、指定したウィンドウの WM_COLORMAP_WINDOWS プロパティを、引き数 colormap_windows で指定したウィンドウのリストに置き換える。 このプロパティが以前に指定されていなければ、 XSetWMColormapWindows は、指定したウィンドウの WM_COLORMAP_WINDOWS を、colormap_windows で指 定したウィンドウのリストに設定する。 プロパティは WINDOW 型、フォーマット 32 で保持される。 WM_COLORMAP_WINDOWS アトムを確保できない場合には、 XSetWMColormapWindows はステータスとして 0 を返す。 そうでない場合には 0 でないステータスを返す。

XSetWMColormapWindows はエラー BadAlloc, BadWindow を起こす場合がある。

関数 XGetWMColormapWindows は、指定したウィンドウの WM_COLORMAP_WINDOWS プロパティに保持されてい るウィンドウ ID のリストを返す。 これらの ID は、ウィンドウマネージャがこのウィンドウをインストールすると きに必要となるカラーマップを示す。 プロパティが存在し、WINDOW 型かつフォーマット 32 であり、アトム WM_COLORMAP_WINDOWS を確保できる場合には、 XGetWMColormapWindows は引き数 windows_return にウィンドウ ID のリストを設定し、引き数 count_return にリストの要素数を設定し、0 でないステータスを返す。 そうでない場合には、関数はいずれの引き数も設定せず、ステータスとして 0 を返す。 ウィンドウ ID のリストを解放するには、 XFree を使用すること。

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

プロパティ

WM_COLORMAP_WINDOWS
トップレベルのウィンドウとは異なるカラーマップを必要とするウィンドウ ID のリスト。

返り値

BadAlloc
要求されたリソースやサーバメモリの割り当てにサーバが失敗した。
BadWindow
引き数 Window が、定義された Window を指していない。