.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

XChangeWindowAttributes, XSetWindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap, XSetWindowColormap - modification des attributs d'une fenêtre

Syntaxe

XChangeWindowAttributes^(^display, f^, masque^, attributs^) Display *display^; Window f^; unsigned long masque^; XSetWindowAttributes *attributs^;
 
  XSetWindowBackground^(^display, f^, pixel_arriere_plan^) Display *display^; Window f^; unsigned long pixel_arriere_plan^;
 
  XSetWindowBackgroundPixmap^(^display, f^, pixmap_arriere_plan^) Display *display^; Window f^; Pixmap pixmap_arriere_plan^;
 
  XSetWindowBorder^(^display, f^, pixel_bordure^) Display *display^; Window f^; unsigned long pixel_bordure^;
 
  XSetWindowBorderPixmap^(^display, f^, pixmap_bordure^) Display *display^; Window f^; Pixmap pixmap_bordure^;
 
  XSetWindowColormap^(^display, f^, palette_couleur^) Display *display^; Window f^; Colormap palette_couleur^;

Arguments

attributs 1i

Spécifie la structure dans laquelle les valeurs des attributs sont lues (en fonction du masque de valeurs). Le masque de valeurs doit avoir les bits appropriés positionnés pour indiquer quels attributs ont été renseignés dans la structure.

pixel_arriere_plan 1i

Spécifie la valeur des pixels de l'arrière-plan.

pixmap_arriere_plan 1i

Spécifie le pixmap de l'arrière-plan, .ZN ParentRelative , ou .ZN None .

pixel_bordure 1i

Spécifie la valeur des pixels de la bordure.

border_pixmap 1i

Spécifie le pixmap pour la bordure ou .ZN CopyFromParent .

display 1i

Spécifie la connexion au serveur X.

masque 1i

Spécifie les attributs de la fenêtre qui sont définis dans l'argument attributs. Ce masque est la combinaison par un OU inclusif bit à bit des masques correspondant aux attributs valides. Si le masque vaut zéro, les attributs sont ignorés et ne sont pas référencés.

f 1i

Spécifie la fenêtre.

palette_couleur 1i

Spécifie la palette de couleurs.

Description

En fonction du masque de valeurs, la fonction .ZN XChangeWindowAttributes utilise les valeurs des attributs renseignées dans la structure .ZN XSetWindowAttributes pour modifier les attributs de la fenêtre. Modifier l'arrière-plan n'entraîne pas un changement du contenu de la fenêtre. Pour reconstituer le dessin d'une fenêtre et de son arrière-plan, utiliser .ZN XClearWindow . Positionner la bordure ou modifier l'arrière-plan de telle sorte que l'origine du pavage de la bordure change, entraîne la reconsitution du dessin de la bordure. Changer l'arrière-plan d'une fenêtre racine à .ZN None ou .ZN ParentRelative restaure le pixmap d'arrière-plan par défaut. Changer la bordure d'une fenêtre racine à .ZN CopyFromParent restaure le pixmap de bordure par défaut. Changer le win-gravity (gravité relative à la fenêtre mère) n'affecte pas la position courante de la fenêtre. Changer le backing-store (mémorisation du contenu) d'une fenêtre masquée à .ZN WhenMapped ou .ZN Always , ou changer les backing-planes (plans mémorisés), backing-pixel (pixels mémorisés) ou save-under (mémorisation des parties masquées) d'une fenêtre affichée peut n'avoir aucun effet immédiat. Changer la palette de couleurs d'une fenêtre (c'est-à-dire, définir une nouvelle palette, et non modifier le contenu d'une palette existante) génère un événement .ZN ColormapNotify . Changer la palette de couleurs d'une fenêtre visible peut n'avoir aucun effet immédiat sur l'écran parce que la palette peut ne pas être installée (voir .ZN XInstallColormap ). Changer le curseur d'une fenêtre racine à .ZN None restaure le curseur par défaut. Chaque fois qu'il est possible de le faire, il est encouragé de partager les palettes de couleurs.
 
  Plusieurs clients peuvent sélectionner les événements sur une même fenêtre. Leurs masques d'événements sont maintenus séparément. Lorsqu'un événement est généré, il est notifié à tous les clients intéressés. Toutefois, un seul client à un instant donné peut sélectionner les événements pour .ZN SubstructureRedirectMask , .ZN ResizeRedirectMask et .ZN ButtonPressMask . Si plusieurs clients tentent de sélectionner n'importe lequel de ces masques d'événements, et si un autre client en a déjà sélectionné un, une erreur .ZN BadAccess est générée. Il n'y a qu'un seul do-not-propagate-mask (NDT. « masque-ne-pas-propager ») pour une fenêtre, et non un par client.
 
  .ZN XChangeWindowAttributes peut générer les erreurs .ZN BadAccess , .ZN BadColor , .ZN BadCursor , .ZN BadMatch , .ZN BadPixmap , .ZN BadValue et .ZN BadWindow .
 
  La fonction .ZN XSetWindowBackground positionne l'arrière-plan d'une fenêtre à la valeur de pixel spécifiée. Changer l'arrière-plan n'entraîne pas la modification du contenu de la fenêtre. .ZN XSetWindowBackground utilise un pixmap de taille indéfinie, rempli avec la valeur de pixel spécifiée en paramètre. Une tentative de modification de l'arrière-plan d'une fenêtre de classe .ZN InputOnly génère une erreur .ZN BadMatch .
 
  .ZN XSetWindowBackground peut générer les erreurs .ZN BadMatch et .ZN BadWindow .
 
  La fonction .ZN XSetWindowBackgroundPixmap affecte le pixmap spécifié à l'arrière-plan de la fenêtre. Le pixmap d'arrière-plan peut immédiatement être libéré si aucune référence explicite n'y est faite ultérieurement. Si la valeur .ZN ParentRelative est spécifiée, le pixmap d'arrière-plan de la fenêtre parente est utilisé, ou sur la fenêtre racine, l'arrière-plan par défaut est restauré. Une tentative pour changer l'arrière-plan d'une fenêtre de classe .ZN InputOnly génère une erreur .ZN BadMatch . Si l'arrière-plan est positionné à .ZN None , la fenêtre n'a plus d'arrière-plan défini.
 
  .ZN XSetWindowBackgroundPixmap peut générer les erreurs .ZN BadMatch , .ZN BadPixmap et .ZN BadWindow .
 
  La fonction .ZN XSetWindowBorder affecte la valeur de pixel spécifiée à la bordure de la fenêtre. Une tentative sur une fenêtre de classe .ZN InputOnly génère une erreur .ZN BadMatch .
 
  .ZN XSetWindowBorder peut générer les erreurs .ZN BadMatch et .ZN BadWindow .
 
  La fonction .ZN XSetWindowBorderPixmap affecte le pixmap spécifié à la bordure de la fenêtre. Le pixmap de bordure peut être libéré immédiatement si aucune référence explicite n'y est faite ultérieurement. Si on spécifie la valeur .ZN CopyFromParent , une copie du pixmap de la bordure de la fenêtre parente est utilisée. Une tentative sur une fenêtre de classe .ZN InputOnly génère une erreur .ZN BadMatch .
 
  .ZN XSetWindowBorderPixmap peut générer les erreurs .ZN BadMatch , .ZN BadPixmap et .ZN BadWindow .
 
  La fonction .ZN XSetWindowColormap affecte la palette de couleurs spécifiée à la fenêtre. La palette doit avoir le même type visuel que la fenêtre, sinon une erreur .ZN BadMatch est générée.
 
  .ZN XSetWindowColormap peut générer les erreurs .ZN BadColor , .ZN BadMatch et .ZN BadWindow .

Diagnostiques

.ZN BadAccess Un client tente de libérer une cellule d'une palette de couleur qu'il n'a pas encore allouée.

.ZN BadAccess Un client tente de modifier une cellule d'une palette de couleur non modifiable.

.ZN BadColor La valeur d'un argument Colormap (palette de couleurs) ne désigne pas une palette de couleurs définie.

.ZN BadCursor La valeur d'un argument Cursor (curseur) ne désigne pas un curseur défini.

.ZN BadMatch Des arguments ou paires d'arguments ont des types et des valeurs corrects, mais ne satisfont pas à d'autres contraintes induites par la requête.

.ZN BadMatch Une fenêtre de classe .ZN InputOnly ne permet pas la modification de cet attribut.

.ZN BadPixmap La valeur d'un argument Pixmap ne désigne pas un pixmap défini.

.ZN BadValue Des valeurs numériques sont hors des limites autorisées par la requête. Sauf précision contraire, toutes les valeurs permises par le type d'un argument sont acceptées par une requête. Un argument défini par une énumération de valeurs peut générer cette erreur.

.ZN BadWindow La valeur d'un argument Window ne désigne pas une fenêtre définie.

Voir aussi

XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XInstallColormap(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11) *(xL

Traduction

Bertrand Duret, 2001.