Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	'" 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 [size=18] [b]Nom[/b] [/size] XCreateWindow, XCreateSimpleWindow, XSetWindowAttributes - création de fenêtres et structure des attributs d'une fenêtre [size=18] [b]Syntaxe[/b] [/size] Window XCreateWindow^(^[i]display[/i], [i]parent[/i]^, [i]x[/i]^, [i]y[/i]^, [i]largeur[/i]^, [i]hauteur[/i]^, [i]largeur_bord[/i]^, [i]profondeur[/i]^, [b][/b] [i]classe[/i]^, [i]type_visuel[/i]^, [i]masque[/i]^, [i]attributs[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]parent[/i]^; [b][/b] int [i]x[/i]^, [i]y[/i]^; [b][/b] unsigned int [i]largeur[/i]^, [i]hauteur[/i]^; [b][/b] unsigned int [i]largeur_bord[/i]^; [b][/b] int [i]profondeur[/i]^; [b][/b] unsigned int [i]classe[/i]^; [b][/b] Visual [i]type_visuel[/i]^ [b][/b] unsigned long [i]masque[/i]^; [b][/b] XSetWindowAttributes [i]attributs[/i]^;     Window XCreateSimpleWindow^(^[i]display[/i], [i]parent[/i]^, [i]x[/i]^, [i]y[/i]^, [i]largeur[/i]^, [i]hauteur[/i]^, [i]largeur_bord[/i]^, [b][/b] [i]bordure[/i]^, [i]arrière-plan[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]parent[/i]^; [b][/b] int [i]x[/i]^, [i]y[/i]^; [b][/b] unsigned int [i]largeur[/i]^, [i]hauteur[/i]^; [b][/b] unsigned int [i]largeur_bord[/i]^; [b][/b] unsigned long [i]bordure[/i]^; [b][/b] unsigned long [i]arrière-plan[/i]^; [size=18] [b]Arguments[/b] [/size] [i]attributs[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]arrière-plan[/i] 1i [table][row][col]    [/col][col]Spécifie la valeur des pixels pour l'arrière-plan de la fenêtre.[/col][/row][/table] [i]bordure[/i] 1i [table][row][col]    [/col][col]Spécifie la valeur des pixels pour la bordure de la fenêtre.[/col][/row][/table] [i]largeur_bord[/i] 1i [table][row][col]    [/col][col]Spécifie la largeur en pixels de la bordure de la fenêtre créée.[/col][/row][/table] [i]classe[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]profondeur[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]display[/i] 1i [table][row][col]    [/col][col]Spécifie la connexion au serveur X.[/col][/row][/table] [i]parent[/i] 1i [table][row][col]    [/col][col]Spécifie la fenêtre parente.[/col][/row][/table] [i]masque[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]type_visuel[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]largeur[/i] 1i [b][/b] [table][row][col]    [/col][col].ns[/col][/row][/table] [i]hauteur[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]x[/i] 1i [b][/b] [table][row][col]    [/col][col].ns[/col][/row][/table] [i]y[/i] 1i [table][row][col]    [/col][col]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[/col][/row][/table] [size=18] [b]Description[/b] [/size] 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 . [size=18] [b]Structures[/b] [/size] 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 à [i][/i](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     [size=18] [b]Diagnostiques[/b] [/size] [table][row][col]    [/col][col].ZN BadAlloc Le serveur a échoué dans l'allocation de la ressource ou de la mémoire serveur requise.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadColor La valeur d'un argument Colormap (palette de couleur) ne désigne pas une palette de couleur définie.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadCursor La valeur d'un argument Cursor (curseur) ne désigne pas un curseur défini.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadMatch Les valeurs n'existent pas pour une fenêtre de classe .ZN InputOnly .[/col][/row][/table] [table][row][col]    [/col][col].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.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadPixmap La valeur d'un argument Pixmap ne désigne pas une pixmap définie.[/col][/row][/table] [table][row][col]    [/col][col].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.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadWindow La valeur d'un argument Window (fenêtre) ne désigne pas une fenêtre définie.[/col][/row][/table] [size=18] [b]Voir aussi[/b] [/size] XChangeWindowAttributes(3X11), XConfigureWindow(3X11), XDefineCursor(3X11), XDestroyWindow(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11) [b][/b] [i][/i]*(xL [size=18] [b]Traduction[/b] [/size] Bertrand Duret, 2001.
Fichier