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

XCreateWindow, XCreateSimpleWindow, XSetWindowAttributes - création de fenêtres et structure des attributs d'une fenêtre

Syntaxe

Window XCreateWindow^(^display, parent^, x^, y^, largeur^, hauteur^, largeur_bord^, profondeur^, classe^, type_visuel^, masque^, attributs^) Display *display^; Window parent^; int x^, y^; unsigned int largeur^, hauteur^; unsigned int largeur_bord^; int profondeur^; unsigned int classe^; Visual *type_visuel^ unsigned long masque^; XSetWindowAttributes *attributs^;
 
  Window XCreateSimpleWindow^(^display, parent^, x^, y^, largeur^, hauteur^, largeur_bord^, bordure^, arrière-plan^) Display *display^; Window parent^; int x^, y^; unsigned int largeur^, hauteur^; unsigned int largeur_bord^; unsigned long bordure^; unsigned long arrière-plan^;

Arguments

attributs 1i

Spécifie la structure contenant les valeurs à considérer (selon le masque de valeurs spécifié). Les bits appropriés doivent être positionnés dans le masque de valeurs pour indiquer quels attributs ont été renseignés dans la structure.

arrière-plan 1i

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

bordure 1i

Spécifie la valeur des pixels pour la bordure de la fenêtre.

largeur_bord 1i

Spécifie la largeur en pixels de la bordure de la fenêtre créée.

classe 1i

Spécifie la classe de la fenêtre créée. Les valeurs possibles sont .ZN InputOutput , .ZN InputOnly , ou .ZN CopyFromParent . La valeur .ZN CopyFromParent signifie que la classe est héritée de la fenêtre parente.

profondeur 1i

Spécifie la profondeur de la fenêtre. La valeur .ZN CopyFromParent signifie que la profondeur est héritée de la fenêtre parente.

display 1i

Spécifie la connexion au serveur X.

parent 1i

Spécifie la fenêtre parente.

masque 1i

Spécifie quels attributs de la fenêtre sont définis par 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.

type_visuel 1i

Spécifie le type visuel (codage des couleurs). La valeur .ZN CopyFromParent signifie que le type visuel est hérité de la fenêtre parente. .ds Wh Ce sont les dimensions intérieures de la fenêtre ; elles n'incluent pas la bordure.

largeur 1i

.ns

hauteur 1i

Spécifie la largeur et la hauteur de la fenêtre créée. *(Wh .ds Xy Elles correspondent à la position du coin de la fenêtre extérieur à la bordure, par rapport au coin de la fenêtre parente intérieur à la bordure.

x 1i

.ns

y 1i

Spécifie les coordonnées x et y du coin supérieur gauche de la fenêtre dans le référentiel de sa fenêtre parente. *(Xy

Description

La fonction .ZN XCreateWindow crée une fenêtre non affichée, fille de la fenêtre parente spécifiée. Elle retourne l'identifiant de la fenêtre créée (window ID) et provoque la génération d'un événement .ZN CreateNotify par le serveur X. La fenêtre créée est placée au sommet de la pile de ses fenêtres soeurs.
 
  Le système de coordonnées comporte un axe X horizontal et un axe Y vertical, dont l'origine [0, 0] correspond au coin supérieur gauche. Les coordonnées sont entières, exprimées en pixels, et coïncident avec le centre des pixels. Chaque fenêtre ou pixmap possède son propre système de coordonnées. Pour une fenêtre, l'origine est à l'intérieur de la bordure dans le coin supérieur gauche.
 
  Les fenêtres de classe .ZN InputOnly doivent être créées avec les paramètres largeur_bord et profondeur à zéro, et le type visuel doit être supporté par l'écran, sinon une erreur .ZN BadMatch est générée. La fenêtre parente peut avoir une profondeur et une classe quelconque. Pour une fenêtre de classe .ZN InputOutput , le type visuel et la profondeur doivent correspondre à une combinaison supportée par l'écran, sinon une erreur .ZN BadMatch est générée. La profondeur ne doit pas nécessairement être la même que celle de la fenêtre parente, mais celle-ci ne peut être une fenêtre de classe .ZN InputOnly , sinon une erreur .ZN BadMatch est générée. Si un attribut invalide est spécifié pour une fenêtre, une erreur .ZN BadMatch est générée.
 
  Lors de la création, la fenêtre n'est pas affichée (mapped) sur le périphérique d'affichage de l'utilisateur. Pour afficher la fenêtre, il faut appeler la fonction .ZN XMapWindow . La fenêtre créée utilise initialement le même curseur que sa fenêtre parente. Un autre curseur peut être associé à la fenêtre en appelant la fonction .ZN XDefineCursor . .IN "Cursor" "Initial State" .IN "XDefineCursor" La fenêtre sera visible sur l'écran si elle et toutes ses ancêtres sont affichées et qu'aucune de ses ancêtres ne la cache. Toute partie de la fenêtre qui déborde de sa fenêtre parente est tronquée.
 
  .ZN XCreateWindow peut générer les erreurs .ZN BadAlloc , .ZN BadColor , .ZN BadCursor , .ZN BadMatch , .ZN BadPixmap , .ZN BadValue , et .ZN BadWindow .
 
  La fonction .ZN XCreateSimpleWindow crée une fenêtre non affichée, fille de la fenêtre parente spécifiée et de classe .ZN InputOutput . Elle retourne l'identifiant de la fenêtre créée (window ID) et provoque la génération d'un événement .ZN CreateNotify par le serveur X. La fenêtre créée est placée au sommet de la pile de ses fenêtres soeurs. La profondeur, la classe et le type visuel d'une fenêtre créée par .ZN XCreateSimpleWindow sont hérités de la fenêtre parente. Tous les autres attributs de la fenêtre ont leur valeur par défaut, exceptés l'arrière-plan et la bordure.
 
  .ZN XCreateSimpleWindow peut générer les erreurs .ZN BadAlloc , .ZN BadMatch , .ZN BadValue , et .ZN BadWindow .

Structures

La structure .ZN XSetWindowAttributes contient les membres :
 
  .IN "XSetWindowAttributes" "" "@DEF@" .Ds 0 .TA .5i 1i .ta .5i 1i typedef struct { Pixmap background_pixmap; /* arrière-plan, None, ou ParentRelative */ unsigned long background_pixel; /* valeur des pixels de l'arrière-plan */ Pixmap border_pixmap; /* bordure de la fenêtre ou CopyFromParent */ unsigned long border_pixel; /* valeur des pixels de la bordure */ 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; /* les bits sous la fenêtre doivent-ils être mémorisés ? (popups) */ long event_mask; /* jeu d'événements devant être conservés */ long do_not_propagate_mask; /* jeu d'événements ne devant pas être propagés */ Bool override_redirect; /* valeur booléenne pour override_redirect (gestionnaire de fenêtre) */ Colormap colormap; /* palette de couleur associée à la fenêtre */ Cursor cursor; /* curseur affiché (ou None) */ } XSetWindowAttributes; .De
 
  Pour une description détaillée des membres de cette structure, on se reportera à *(xL^.
 
  Bits du masque de valeurs pour les attributs de fenêtre : .TS lw(.5i) lw(2.5i) lw(.8i). T{ #define T} T{ .ZN CWBackPixmap T} T{ (1L<<0) T} T{ #define T} T{ .ZN CWBackPixel T} T{ (1L<<1) T} T{ #define T} T{ .ZN CWBorderPixmap T} T{ (1L<<2) T} T{ #define T} T{ .ZN CWBorderPixel T} T{ (1L<<3) T} T{ #define T} T{ .ZN CWBitGravity T} T{ (1L<<4) T} T{ #define T} T{ .ZN CWWinGravity T} T{ (1L<<5) T} T{ #define T} T{ .ZN CWBackingStore T} T{ (1L<<6) T} T{ #define T} T{ .ZN CWBackingPlanes T} T{ (1L<<7) T} T{ #define T} T{ .ZN CWBackingPixel T} T{ (1L<<8) T} T{ #define T} T{ .ZN CWOverrideRedirect T} T{ (1L<<9) T} T{ #define T} T{ .ZN CWSaveUnder T} T{ (1L<<10) T} T{ #define T} T{ .ZN CWEventMask T} T{ (1L<<11) T} T{ #define T} T{ .ZN CWDontPropagate T} T{ (1L<<12) T} T{ #define T} T{ .ZN CWColormap T} T{ (1L<<13) T} T{ #define T} T{ .ZN CWCursor T} T{ (1L<<14) T} .TE
 
 

Diagnostiques

.ZN BadAlloc Le serveur a échoué dans l'allocation de la ressource ou de la mémoire serveur requise.

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

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

.ZN BadMatch Les valeurs n'existent pas pour une fenêtre de classe .ZN InputOnly .

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

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

.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 (fenêtre) ne désigne pas une fenêtre définie.

Voir aussi

XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XDefineCursor(3X11), XDestroyWindow(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11) *(xL

Traduction

Bertrand Duret, 2001.