NOM¶

XInstallColormap, XUninstallColormap, XListInstalledColormaps - contrôle les palettes de couleurs

SYNTAXE¶

XInstallColormap(display, palette)
Display *display;
Colormap palette;

XUninstallColormap(display, palette)
Display *display;
Colormap palette;

Colormap *XListInstalledColormaps(display, f, num_retour)
Display *display;
Window f;
int *num_retour;

ARGUMENTS¶

palette

Spécifie la palette.

display

Spécifie la connexion au serveur X.

num_retour

Renvoie le nombre de palettes de couleurs actuellement installées.

f

Spécifie une fenêtre permettant de déterminer l'écran.

DESCRIPTION¶

La fonction XInstallColormap installe la palette de couleurs spécifiée pour l'écran associé. Toutes les fenêtres associées à cette palette sont immédiatement affichées avec les vraies couleurs. L'association des fenêtres à cette palette a été réalisée lors de l'appel à l'une des fonctions XCreateWindow, XCreateSimpleWindow, XChangeWindowAttributes, ou XSetWindowColormap.

Si la palette spécifiée n'est pas déjà installée, le serveur X génère un événement ColormapNotify pour chaque fenêtre qui dispose de cette palette. De plus, pour toute autre palette qui est installée par un appel à XInstallColormap, le serveur X génère un événement ColormapNotify pour chaque fenêtre qui dispose de cette palette.

XInstallColormap peut générer une erreur BadColor.

La fonction XUninstallColormap supprime la palette de couleurs spécifiée de la liste requise pour son écran. En conséquence, la palette spécifiée peut être désinstallée, et le serveur X peut implicitement installer ou désinstaller des palettes de couleurs supplémentaires. Quelles palettes sont installées ou dés-installées dépend du serveur, excepté que la liste requise demeure installée.

Si la palette spécifiée est désinstallée, le serveur génère un événement ColormapNotify pour chaque fenêtre disposant de cette palette. De plus pour chaque autre palette de couleur qui est installée ou désinstallée par un appel à XUninstallColormap, le serveur X génère un événement ColormapNotify pour chaque fenêtre qui dispose de la palette.

XUninstallColormap peut générer une erreur BadColor.

La fonction XListInstalledColormaps retourne une liste des palettes de couleur actuellement installées sur l'écran de la fenêtre spécifiée. L'ordre des palettes dans la liste n'est pas significatif et n'est pas une indication explicite de la liste requise. Lorsque la liste n'est plus utilisée, il est nécessaire de la détruire en appelant XFree.

XListInstalledColormaps peut générer une erreur BadWindow.

DIAGNOSTICS¶

BadColor

Une valeur pour un argument Colormap ne référence pas une palette de couleurs définie.

BadWindow

Une valeur pour un argument Window ne référence pas une fenêtre définie.

VOIR AUSSI¶

XChangeWindowAtrributes(3X11), XCreateColormap(3X11), XCreateWindow(3X11), XFree(3X11)
Xlib - C Language X Interface

TRADUCTION¶

Bertrand Duret, 2002.