関数

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.1C