.ds xT X Toolkit Intrinsics - C Language Interface .ds xW Athena X Widgets - C Language X Toolkit Interface .ds xL Xlib - C Language X Interface .ds xC Inter-Client Communication Conventions Manual .na .de Ds .nf .ft 1 .. .de De .ce 0 .if
(BD .DF .nr BD 0 .in
(OIu .if
(TM .ls 2
(DDu .fi .. .de FD
 
  .KS .TA .5i 3i .ta .5i 3i .nf .. .de FN .fi .KE

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 1i

Spécifie la palette.

display 1i

Spécifie la connexion au serveur X.

num_retour 1i

Renvoie le nombre de palettes de couleurs actuellement installées. .ds Wi permettant de déterminer l'écran

f 1i

Spécifie une fenêtre *(Wi.

Description

La fonction .ZN 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 .ZN XCreateWindow , .ZN XCreateSimpleWindow , .ZN XChangeWindowAttributes , ou .ZN XSetWindowColormap .
 
  Si la palette spécifiée n'est pas déjà installée, le serveur X génère un événement .ZN ColormapNotify pour chaque fenêtre qui dispose de cette palette. De plus, pour toute autre palette qui est installée par un appel à .ZN XInstallColormap , le serveur X génère un événement .ZN ColormapNotify pour chaque fenêtre qui dispose de cette palette.
 
  .ZN XInstallColormap peut générer une erreur .ZN BadColor .
 
  La fonction .ZN 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 .ZN 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 à .ZN XUninstallColormap , le serveur X génère un événement .ZN ColormapNotify pour chaque fenêtre qui dispose de la palette.
 
  .ZN XUninstallColormap peut générer une erreur .ZN BadColor .
 
  La fonction .ZN 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 .ZN XFree .
 
  .ZN XListInstalledColormaps peut générer une erreur .ZN BadWindow .

Diagnostiques

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

.ZN 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) *(xL

Traduction

Bertrand Duret, 2002.