'" t .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

XGetWindowAttributes, XGetGeometry, XWindowAttributes - obtention des attributs courants ou la géométrie courante d'une fenêtre et structure des attributs courants

Syntaxe

Status XGetWindowAttributes^(^display, f^, retour_attributs_fenêtre^) Display *display^; Window f^; XWindowAttributes *retour_attributs_fenêtre^;
 
  Status XGetGeometry^(^display, d^, ^retour_racine^, retour_x^, retour_y^, retour_largeur^, retour_hauteur^, retour_largeur_bordure^, retour_profondeur^) Display *display^; Drawable d^; Window *retour_racine^; int *retour_x^, *retour_y^; unsigned int *retour_largeur^, *retour_hauteur^; unsigned int *retour_largeur_bordure^; unsigned int *retour_profondeur^;

Arguments

retour_largeur_bordure 1i

Retourne la largeur de la bordure en pixels. .ds Dr , qui peut être une fenêtre ou un pixmap

d 1i

Spécifie la zone de dessin*(Dr.

retour_profondeur 1i

Retourne la profondeur de la zone de dessin (bits par pixel pour l'objet).

display 1i

Spécifie la connexion au serveur X.

retour_racine 1i

Retourne la fenêtre racine. .ds Wi dont on veut obtenir les attributs courants

f 1i

Spécifie la fenêtre *(Wi.

retour_largeur 1i

.ns

retour_hauteur 1i

Retourne les dimensions de la zone de dessin (largeur et hauteur).

retour_attributs_fenêtre 1i

Retourne les attributs de la fenêtre spécifiée dans la structure .ZN XWindowAttributes .

retour_x 1i

.ns

retour_y 1i

Retourne les coordonnées x et y qui définissent la position de la zone de dessin. Pour une fenêtre, elles représentent les coordonnées externes du coin supérieur gauche relativement à l'origine de la fenêtre parente. Pour les pixmaps, elles valent toujours zéro.

Description

La fonction .ZN XGetWindowAttributes renvoie dans une structure .ZN XWindowAttributes les attributs courants de la fenêtre spécifiée.
 
  .ZN XGetWindowAttributes peut générer des erreurs .ZN BadDrawable et .ZN BadWindow .
 
  La fonction .ZN XGetGeometry retourne la fenêtre racine et la géométrie courante de la zone de dessin. La géométrie d'une zone de dessin comprend les coordonnées x et y, la largeur, la hauteur, la largeur de la bordure et la profondeur. Ceux-ci sont décrits dans la liste des arguments. Il est légal d'appliquer cette fonction à une fenêtre de classe .ZN InputOnly .

Structures

La structure .ZN XWindowAttributes contient :
 
  .Ds 0 .TA .5i 3i .ta .5i 3i typedef struct { int x, y; /* position de la fenêtre */ int width, height; /* largeur et hauteur de la fenêtre */ int border_width; /* largeur de la bordure de la fenêtre */ int depth; /* profondeur de la fenêtre */ Visual *visual; /* la structure visual associée */ Window root; /* fenêtre racine de l'écran contenant la fenêtre */ int class; /* InputOutput, InputOnly */ int bit_gravity; /* une des valeurs des bits de gravité */ int win_gravity; /* une des valeurs de gravité de fenêtre */ int backing_store; /* NotUseful, WhenMapped, Always */ unsigned long backing_planes; /* plans à mémoriser si possible */ unsigned long backing_pixel; /* valeur de pixel à utiliser lors de la restauration des plans */ Bool save_under; /* booléen, les bits sous la fenêtre doivent-ils être mémorisés ? */ Colormap colormap; /* palette de couleurs associée à la fenêtre */ Bool map_installed; /* booléen, la palette de couleur est-elle actuellement installée */ int map_state; /* IsUnmapped, IsUnviewable, IsViewable */ long all_event_masks; /* événements sélectionnés par tous les programmes */ long your_event_mask; /* mon masque d'événements */ long do_not_propagate_mask; /* événements à ne pas propager */ Bool override_redirect; /* valeur booléenne pour override-redirect */ Screen *screen; /* pointeur inverse sur l'écran */ } XWindowAttributes; .De
 
  Les membres x et y représentent le coin externe supérieur gauche relativement à l'origine de la fenêtre parente. Les membres width et height représentent la taille interne de la fenêtre, sans compter sa bordure. Le membre border_width représente la largeur de la bordure de la fenêtre, exprimée en pixels. Le membre depth représente la profondeur de la fenêtre (soit le nombre de bits par pixel pour l'objet). Le membre visual est un pointeur sur la structure .ZN Visual associée à l'écran. Le membre root représente la fenêtre racine de l'écran contenant la fenêtre. Le membre class représente la classe de la fenêtre et peut prendre pour valeur soit .ZN InputOutput soit .ZN InputOnly .
 
  Le membre bit_gravity représente le bit de gravité positionné pour la fenêtre et peut prendre l'une des valeurs suivantes :
 
  .TS lw(2i) lw(2i). T{ .ZN ForgetGravity T} T{ .ZN EastGravity T} T{ .ZN NorthWestGravity T} T{ .ZN SouthWestGravity T} T{ .ZN NorthGravity T} T{ .ZN SouthGravity T} T{ .ZN NorthEastGravity T} T{ .ZN SouthEastGravity T} T{ .ZN WestGravity T} T{ .ZN StaticGravity T} .ZN CenterGravity .TE
 
  Le membre win_gravity représente la gravité des fenêtres de la fenêtre et peut prendre l'une des valeurs suivantes :
 
  .TS lw(2i) lw(2i). T{ .ZN UnmapGravity T} T{ .ZN EastGravity T} T{ .ZN NorthWestGravity T} T{ .ZN SouthWestGravity T} T{ .ZN NorthGravity T} T{ .ZN SouthGravity T} T{ .ZN NorthEastGravity T} T{ .ZN SouthEastGravity T} T{ .ZN WestGravity T} T{ .ZN StaticGravity T} .ZN CenterGravity .TE
 
  Pour des informations supplémentaires sur la gravité, voir section 3.3.
 
  Le membre backing_store (mémoire auxiliaire) représente la façon dont le serveur X doit maintenir le contenu de la fenêtre lorsqu'elle est retirée de l'affichage. Il peut prendre la valeur .ZN WhenMapped , .ZN Always , ou .ZN NotUseful . Le membre backing_planes représente (par les bits positionnés à 1) quels plans de bits de la fenêtre possèdent des données dynamiques qui doivent être préservées dans la mémoire auxiliaire et pendant les mémorisations des parties cachées (save_under). Le membre backing_pixel représente la valeur à affecter aux plans non pris en charge dans les backing_planes.
 
  Le membre save_under vaut soit .ZN True soit .ZN False . Le membre colormap représente la palette de couleurs pour la fenêtre spécifiée et peut prendre pour valeur l'ID d'une palette ou .ZN None . Le membre map_installed indique si la palette de couleurs est actuellement installée et peut prendre pour valeur .ZN True ou .ZN False . Le membre map_state indique l'état de la fenêtre et peut prendre pour valeur .ZN IsUnmapped , .ZN IsUnviewable , ou .ZN IsViewable . .ZN IsUnviewable est utilisé dans le cas où la fenêtre est affichée, mais une de ses ancêtres ne l'est pas.
 
  Le membre all_event_masks représente la combinaison par un OU inclusif bit à bit de tous les masques d'événements sélectionnés sur la fenêtre par l'ensemble des clients. Le membre your_event_mask représente la combinaison par un OU inclusif bit à bit des masques d'événements sélectionnés par le client effectuant la requête. Le membre do_not_propagate_mask représente la combinaison par un OU inclusif bit à bit des événements qui ne doivent pas se propager.
 
  Le membre override_redirect indique si la fenêtre échappe aux moyens de contrôle des structures (SubstructureRedirectMask) et peut prendre les valeurs .ZN True ou .ZN False . Les gestionnaires de fenêtre devraient ignorer la fenêtre si ce membre vaut .ZN True .
 
  Le membre screen est un pointeur sur l'écran auquel est associée la fenêtre. Cela permet d'obtenir facilement les informations de l'écran sans avoir à le retrouver à partir de la fenêtre racine.

Diagnostiques

.ZN BadDrawable La valeur d'un argument Drawable ne correspond pas à une fenêtre ou un pixmap définis.

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

Voir aussi

XQueryPointer(3X11), XQueryTree(3X11) *(xL

Traduction

Bertrand Duret, 2002.