winfo

 

winfo - Donne les informations relatives à la fenêtre


SYNTAXE

 winfo option ?arg arg ...?

DESCRIPTION


La commande winfo est utilisée pour obtenir l'information au sujet des fenêtres prises en charge par Tk. Elle peut prendre n'importe quelle forme, ceci dépendant de l'argument option. Les formes légales sont:

winfo atom ?-displayof fenêtre? NOM Retourne une chaîne décimale désignant l'identificateur entier de l'atome dont le nom est NOM. Si aucun atome de ce nom existe alors un nouveau est créé. Si l'option -displayof est indiquée alors l'atome est recherché dans l'écran de fenêtre; autrement il est recherché dans l'écran de la fenêtre principale de l'application.

winfo atomname ?-displayof fenêtre? id Retourne le nom textuel de l'atome dont l'identificateur entier est id. Si l'option -displayof est indiquée alors l'identificateur est recherché à l'écran de fenêtre; autrement il est recherché dans l'écran de la fenêtre principale de l'application. cette commande est l'inverse de la commande winfo atom. Elle génère une erreur si l'atome n'existe pas.

winfo cells fenêtre Retourne une chaîne décimale désignant le nombre de cellules dans la palette de fenêtre.

winfo childrenfenêtre Retourne une liste contenant le nom de chemins de tous les enfants de fenêtre. La liste est dans l'ordre d'empilement, avec la fenêtre la plus basse en premier. Les fenêtres top-level sont retournées comme enfants de leurs parents logiques.

winfo class fenêtre Retourne le nom de classe de fenêtre.

winfo colormapfull fenêtre Retourne 1 si la palette de fenêtre est pleine, 0 autrement. La palette d'une fenêtre est pleine si la dernière tentative d'allouer une nouvelle couleur à cette fenêtre a échoué et que l'application n'a libéré aucune couleur depuis l'allocation ratée.

winfo containing?-displayof fenêtre? rootX rootY Retourne le nom de chemin de la fenêtre contenant le point indiqué par rootX et rootY. RootX et rootY sont spécifiés en unités d'écran (c.a.d. toute forme acceptable par GetPixels) dans les coordonnées système de la fenêtre mère(si un gestionnaire de fenêtres virtuel est utilisé alors les coordonnées système de la fenêtre mère virtuelle est utilisé). Si l'option -displayof est indiquée alors les coordonnées se référent à l'écran contenant fenêtre; autrement ils se référent à l'écran de la fenêtre principale de l'application. Si aucune fenêtre de cette application ne contient le point alors une chaîne vide est retournée. Dans la sélection de la fenêtre contenante, il est donné aux enfants une priorité supérieure à celle des parents et parmi les enfants le plus haut dans l'ordre d'empilement est choisi.

winfo depth fenêtre Retourne une chaîne décimale indiquant la profondeur de fenêtre (nombre de bits par pixel).

winfo existsfenêtre Retourne 1 s'il existe une fenêtre nommée fenêtre, 0 si non.

winfo fpixels fenêtre nombre Retourne une valeur flottante indiquant le nombre de pixels dans fenêtre correspondant à la distance indiquée par nombre. Nombre peut être spécifié sous n'importe quelle des formes acceptables par GetPixels, comme ``2.0c ou ``1i. La valeur de retour peut être fractionnelle; pour une valeur entière, utilisez winfo pixels.

winfo geometry fenêtre Retourne la géométrie de fenêtre, sous la forme widthxhauteur+x+y. Toutes les dimensions sont en pixels.

winfo heightfenêtre Retourne une chaîne décimale indiquant la hauteur de fenêtre en pixels. Quand une fenêtre est créée pour la première fois sa hauteur sera de 1 pixel; la hauteur sera éventuellement modifiée par le gestionnaire de géométrie pour satisfaire les besoins (d'espace... NDT.) de la fenêtre. Si vous avez besoin de la hauteur véritable immédiatement après la création d'un widget, appelez update pour forcer le gestionnaire de géométrie à le dimensionner, ou utilisez winfo reqheight pour obtenir la hauteur de fenêtre demandée à la place de sa hauteur actuelle.

winfo idfenêtre Retourne une chaîne hexadécimale indiquant un identificateur de bas niveau spécifique à la plate-forme pour fenêtre. Sous Unix, c'est the identificateur de fenêtre X. Sous Windows, c'est le HWND Windows. Sur Macintosh la valeur n'a pas de sens en dehors de Tk.

winfo interps ?-displayof fenêtre? Retourne une liste dont les membres sont les noms de tous les interpréteurs Tcl (ex. toutes les applications Tk) actuellement enregistrées pour un écran particulier. Si l'option -displayof est indiquée alors la valeur de retour se réfère à l'écran de fenêtre; autrement elle se réfère à l'écran de la fenêtre principale de l'application.

winfo ismapped fenêtre Retourne 1 si fenêtre est actuellement mappée, 0 autrement.

winfo manager fenêtre Retourne le nom du gestionnaire de géométrie actuellement responsable de fenêtre, ou une chaîne vide si fenêtre n'est prise en charge par aucun gestionnaire de géométrie. Le nom est généralement le nom de la commande Tcl pour le gestionnaire de géométrie, comme pack ou place. Si le gestionnaire de géométrie est un widget, comme canvas ou texte, le nom est la commande de la classe de widget, comme canvas.

winfo name fenêtre Retourne le nom de fenêtre (c.a.d. son nom à l'intérieur de son parent, contrairement à son nom de chemin complet). La commande winfo name . retournera le nom de l'application.

winfo parent fenêtre Retourne le nom de chemin du parent de fenêtre, ou une chaîne vide si fenêtre est la fenêtre principale de l'application.

winfo pathname ?-displayof fenêtre? id Retourne le nom de chemin de la fenêtre dont l'identificateur X est id. Id doit être un entier décimal, hexadécimal, ou octal et doit correspondre à une fenêtre dans l'application appelante. Si l'option -displayof est indiquée alors l'identificateur est recherché à l'écran de fenêtre; autrement il est recherché à l'écran de la fenêtre principale de l'application.

winfo pixels fenêtre nombre Retourne le nombre de pixels dans fenêtre correspondant à la distance indiquée par nombre. Nombre peut être spécifié sous n'importe quelle des formes acceptables par GetPixels, comme ``2.0c ou ``1i. Le résultat est arrondi à la valeur entière la plus proche; pour un résultat fractionnel, utilisez winfo fpixels.

winfo pointerx fenêtre Si le pointeur de souris est sur le même écran que fenêtre, retourne la coordonnée x du pointeur, mesurée en pixels dans l'écran de la fenêtre mère. Si une fenêtre mère virtuelle est utilisée sur l'écran, la position est mesurée dans la mère virtuelle. Si le pointeur de souris n'est pas sur le même l'écran que fenêtre alors -1 est retourné.

winfo pointerxy fenêtre Si le pointeur de souris est sur le même écran que fenêtre, retourne une liste de deux éléments, qui sont les coordonnées x et y du pointeur mesurées en pixels dans l'écran de fenêtre. Si une fenêtre mère virtuelle est utilisée sur l'écran, la position est calculée dans la mère virtuelle. Si le pointeur de souris n'est pas sue le même écran que fenêtre alors les deux coordonnées retournées sont -1.

winfo pointery fenêtre Si le pointeur de souris est sur le même écran que fenêtre, retourne la coordonnée y du pointeur, mesurée en pixels dans l'écran de la fenêtre mère. Si une fenêtre mère virtuelle est utilisée sur l'écran, la position est mesurée dans la mère virtuelle. Si le pointeur de souris n'est pas sur le même l'écran que fenêtre alors -1 est retourné.

winfo reqheight fenêtre Retourne une chaîne décimale indiquant la hauteur demandée de fenêtre, en pixels. C'est la valeur utilisée par le gestionnaire de géométrie de fenêtre pour calculer sa géométrie.

winfo reqwidth fenêtre Retourne une chaîne décimale indiquant la largeur demandée de fenêtre, en pixels. C'est la valeur utilisée par le gestionnaire de géométrie de fenêtre pour calculer sa géométrie.

winfo rgb fenêtre couleur Retourne une liste contenant trois valeurs décimales, qui sont les nuances de rouge, vert, et bleu qui correspondent à couleur dans la fenêtre indiquée par fenêtre. Couleur peut être indiqué sous n'importe quelle des formes acceptable par une option de couleur.

winfo rootx fenêtre Retourne une chaîne décimale indiquant la coordonnée x, dans la fenêtre racine de l'écran, du coin supérieur gauche de la bordure de fenêtre (ou fenêtre si elle n'a pas de bordure).

winfo rooty fenêtre Retourne une chaîne décimale indiquant la coordonnée y, dans la fenêtre racine de l'écran, du coin supérieur gauche de la bordure de fenêtre (ou fenêtre si elle n'a pas de bordure).

winfo screen fenêtre Retourne le nom de l'écran associé à fenêtre, sous la formedisplayName.screenIndex.

winfo screencells fenêtre Retourne une chaîne décimale indiquant le nombre de cellules dans la palette par défaut de fenêtre.

winfo screendepth fenêtre Retourne une chaîne décimale indiquant la profondeur de la fenêtre mère de fenêtre (nombre de bits par pixel).

winfo screenheight fenêtre Retourne une chaîne décimale indiquant la hauteur de fenêtre en pixels.

winfo screenmmheight fenêtre Retourne une chaîne décimale indiquant la hauteur de fenêtre en millimètres.

winfo screenmmwidth fenêtre Retourne une chaîne décimale indiquant la largeur de fenêtre en millimètres.

winfo screenvisual fenêtre Retourne une des chaînes suivantes pour indiquer la classe visuelle par défaut de fenêtre: directcolor, grayscale, pseudocolor, staticcolor, staticgray, ou truecolor.

winfo screenwidth fenêtre Retourne une chaîne décimale indiquant la largeur de fenêtre en pixels.

winfo server fenêtre Retourne une chaîne contenant information sur le de fenêtre. Le format exact de cette chaîne peut varier de plate-forme à plate-forme. Pour les serveurs X la chaîne a la forme``XmajorRminor vendor vendorVersionmajor et minor sont les numéros de version et de revision fournis par le serveur (ex., X11R5), vendor est le nom du distributeur du serveur, et vendorRelease'' est un numéro entier de release fourni par le serveur.

winfo toplevel fenêtre Retourne le nom de chemin de la fenêtre top-level contenant fenêtre.

winfo viewable fenêtre Retourne 1 si fenêtre et tous ses ancêtres jusqu'à la plus proche toplevel sont mappés. Retourne 0 s'il existe une de ces fenêtres qui n'est pas pas mappée.

winfo visual fenêtre Retourne une des chaînes suivantes pour indiquer la classe visuelle de fenêtre: directcolor, grayscale, pseudocolor, staticcolor, staticgray, ou truecolor.

winfo visualid fenêtre Retourne l'identificateur X visuel de fenêtre.

winfo visualsavailable fenêtre ?includeids? Retourne une liste dont les éléments décrivent les visuels disponibles pour fenêtre. Chaque élément consiste en une classe visuelle suivi par une profondeur entière. La classe a la même forme que retournée par winfo visual. La profondeur donne le nombre de bits par pixel dans le visuel. De plus, si l'argument includeids est fourni, alors la profondeur est suivie par l'identificateur X du visuel.

winfo vrootheight fenêtre Retourne la hauteur de la fenêtre racine virtuelle associée à fenêtre s'il y en a une; autrement retourne la hauteur de fenêtre.

winfo vrootwidth fenêtre Retourne la largeur de la fenêtre racine virtuelle associée à fenêtre s'il y en a une; autrement retourne la largeur de fenêtre.

winfo vrootx fenêtre Retourne l'offset x de la fenêtre racine virtuelle associée à fenêtre, relativement à la la fenêtre racinee de son écran. Est normalement soit zéro soit négatif. Retourne 0 s'il n'y a pas de fenêtre racine virtuelle associée à fenêtre.

winfo vrooty fenêtre Retourne l'offset y-offset de la fenêtre racine virtuelle associée à fenêtre, relativement à la la fenêtre racinee de son écran. Est normalement soit zéro soit négatif. Retourne 0 s'il n'y a pas de fenêtre racine virtuelle associée à fenêtre.

winfo width fenêtre Retourne une chaîne décimale indiquant la largeur de fenêtre en pixels. Quand a fenêtre est créée pour la première fois sa largeur est de 1 pixel; la largeur sera éventuellement modifiée par le gestionnaire de géométrie pour satisfaire les besoins de la fenêtre. Si vous avez besoin de la largeur véritable immédiatement après la création d'un widget, appelezupdate pour forcer le gestionnaire de géométrie à le dimensionner, ou utilisez winfo reqwidth pour obtenir la largeur de fenêtre demandée à la place de sa hauteur actuelle.

winfo x fenêtre Retourne une chaîne décimale indiquant la coordonnée x, dans le parent defenêtre, du coin supérieur gauche de la bordure de fenêtre(ou fenêtre si it n'a pas de bordure).

winfo y fenêtre Retourne une chaîne décimale indiquant la coordonnée y, dans le parent defenêtre, du coin supérieur gauche de la bordure de fenêtre(ou fenêtre si it n'a pas de bordure).


Traduit par Michel Salvagniac 2002-2003

Copyright © 2003 - Le Wiki Tcl/Tk Francophone.


Catégorie Manuel Tcl/Tk