Name

XtSetWMColormapWindows — set WM_COLORMAP_WINDOWS property to inform window manager of custom colormaps. 

Synopsis

void XtSetWMColormapWindows(widget, list, count)

      Widget widget;
      Widget ∗list;
      Cardinal count;

Arguments

widgetSpecifies the widget on whose window the WM_COLORMAP_WINDOWS property will be stored. 

listSpecifies a list of widgets whose windows are to be listed in the WM_COLORMAP_WINDOWS property. 

countSpecifies the number of widgets in list. 

Description

XtSetWMColormapWindows returns immediately if widget is not realized or if count is 0.  Otherwise, XtSetWMColormapWindows constructs an ordered list of windows by examining each widget in the list in turn and:

•Ignoring the widget if it is not realized or

•Adding the widget’s window to the window list if the widget is realized and if its colormap resource differs from the colormap resources of all widgets whose windows are already on the window list. 

Finally, XtSetWMColormapWindows stores the resulting window list in the WM_COLORMAP_WINDOWS property on the specified widget’s window.  This tells the window manager which windows have a custom colormap, so that the window manager can install these colormaps at the appropriate time.