XtSetWMColormapWindows()XtSetWMColormapWindows()NameXtSetWMColormapWindows - set WM_COLORMAP_WINDOWS property to inform
window manager of custom colormaps.
Synopsis
void XtSetWMColormapWindows(widget, list, count)
Widget widget;
Widget* list;
Cardinal count;
Inputs
widget Specifies the widget on whose window the WM_COLORMAP_WINDOWS
property will be stored. Must be of class Core or any sub‐
class thereof.
list Specifies a list of widgets whose windows are to be listed in
the WM_COLORMAP_WINDOWS property.
count Specifies the number of widgets in list.
Availability
Release 4 and later.
DescriptionXtSetWMColormapWindows() 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 real‐
ized 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.
See section 4.1.8 of the Inter-Client Communications Conventions Manual
for details on the meaning of the WM_COLORMAP_WINDOWS property.
Usage
Only applications that make sophisticated use of color and use multiple
colormaps will ever need to call this function.
Xt - Properties XtSetWMColormapWindows()