名称

XSetWMColormapWindows、XGetWMColormapWindows − ウィンドウの WM_COLORMAP_WINDOWS 属性を設定と読み出し

形式

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;

引数

displayX サーバへの接続を指定します。

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 atom を制限出来ない場合、 XSetWMColormapWindows はステータスゼロを返します。 そうでなければ、ゼロ以外のステータスを返します。 XSetWMColormapWindows で発生するエラーには、 BadAlloc および BadWindow エラーがあります。 XGetWMColormapWindows 関数は指定ウィンドウの WM_COLORMAP_WINDOWS 属性に 格納されたウィンドウ識別子のリストを返します。 この識別子はウィンドウマネージャが このウィンドウに設定する必要がある場合のカラーマップを示します。 タイプが WINDOW、 フォーマットが 32 の属性が存在し、atom WM_COLORMAP_WINDOWS が制限される場合、 XGetWMColormapWindows は引数 windows_return をウィンドウ識別子のリストへ設定、 引数 count_return をリストの項目数に設定、 そしてゼロ以外のステータスを返します。 そうでなければ、 返された引数のどちらも設定せず、 ゼロステータスを返します。 ウィンドウ識別子のリストを解放するためには XFree を使います。 XGetWMColormapWindows で発生するエラーには BadWindow エラーがあります。

属性

WM_COLORMAP_WINDOWS
ウィンドウ ID のリストのカラーマップはトップレベルのウィンドウと異なる ものが必要かもしれません。

診断

BadAlloc サーバがリクエストされたリソースまたはサーバメモリの割り当てに失敗した。

BadWindow
Window 引数に対する値が定義されたウィンドウに一致しない。

関連事項

XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11), XStringListToTextProperty(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R