Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	.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] XChangeWindowAttributes, XSetWindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap, XSetWindowColormap - modification des attributs d'une fenêtre [size=18] [b]Syntaxe[/b] [/size] XChangeWindowAttributes^(^[i]display[/i], [i]f[/i]^, [i]masque[/i]^, [i]attributs[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]f[/i]^; [b][/b] unsigned long [i]masque[/i]^; [b][/b] XSetWindowAttributes [i]attributs[/i]^;     XSetWindowBackground^(^[i]display[/i], [i]f[/i]^, [i]pixel_arriere_plan[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]f[/i]^; [b][/b] unsigned long [i]pixel_arriere_plan[/i]^;     XSetWindowBackgroundPixmap^(^[i]display[/i], [i]f[/i]^, [i]pixmap_arriere_plan[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]f[/i]^; [b][/b] Pixmap [i]pixmap_arriere_plan[/i]^;     XSetWindowBorder^(^[i]display[/i], [i]f[/i]^, [i]pixel_bordure[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]f[/i]^; [b][/b] unsigned long [i]pixel_bordure[/i]^;     XSetWindowBorderPixmap^(^[i]display[/i], [i]f[/i]^, [i]pixmap_bordure[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]f[/i]^; [b][/b] Pixmap [i]pixmap_bordure[/i]^;     XSetWindowColormap^(^[i]display[/i], [i]f[/i]^, [i]palette_couleur[/i]^) [b][/b] Display [i]display[/i]^; [b][/b] Window [i]f[/i]^; [b][/b] Colormap [i]palette_couleur[/i]^; [size=18] [b]Arguments[/b] [/size] [i]attributs[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]pixel_arriere_plan[/i] 1i [table][row][col]    [/col][col]Spécifie la valeur des pixels de l'arrière-plan.[/col][/row][/table] [i]pixmap_arriere_plan[/i] 1i [table][row][col]    [/col][col]Spécifie le pixmap de l'arrière-plan, .ZN ParentRelative , ou .ZN None .[/col][/row][/table] [i]pixel_bordure[/i] 1i [table][row][col]    [/col][col]Spécifie la valeur des pixels de la bordure.[/col][/row][/table] [i]border_pixmap[/i] 1i [table][row][col]    [/col][col]Spécifie le pixmap pour la bordure ou .ZN CopyFromParent .[/col][/row][/table] [i]display[/i] 1i [table][row][col]    [/col][col]Spécifie la connexion au serveur X.[/col][/row][/table] [i]masque[/i] 1i [table][row][col]    [/col][col]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.[/col][/row][/table] [i]f[/i] 1i [table][row][col]    [/col][col]Spécifie la fenêtre.[/col][/row][/table] [i]palette_couleur[/i] 1i [table][row][col]    [/col][col]Spécifie la palette de couleurs.[/col][/row][/table] [size=18] [b]Description[/b] [/size] 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 . [size=18] [b]Diagnostiques[/b] [/size] [table][row][col]    [/col][col].ZN BadAccess Un client tente de libérer une cellule d'une palette de couleur qu'il n'a pas encore allouée.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadAccess Un client tente de modifier une cellule d'une palette de couleur non modifiable.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadColor La valeur d'un argument Colormap (palette de couleurs) ne désigne pas une palette de couleurs 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 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.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadMatch Une fenêtre de classe .ZN InputOnly ne permet pas la modification de cet attribut.[/col][/row][/table] [table][row][col]    [/col][col].ZN BadPixmap La valeur d'un argument Pixmap ne désigne pas un pixmap défini.[/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 ne désigne pas une fenêtre définie.[/col][/row][/table] [size=18] [b]Voir aussi[/b] [/size] XConfigureWindow(3X11), XCreateWindow(3X11), XDestroyWindow(3X11), XInstallColormap(3X11), XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11) [b][/b] [i][/i](xL [size=18] [b]Traduction[/b] [/size] Bertrand Duret, 2001.
Fichier