  NOM
    winfo - Donne les informations relatives à la fenêtre
  SYNTAXE
    winfo option ?arg arg ...?
  DESCRIPTION
    winfo atom ?-displayof fenêtre? NOM
    winfo atomname ?-displayof fenêtre? id
    winfo cells fenêtre
    winfo child fenêtre
    winfo class fenêtre
    winfo colormapfull fenêtre
    winfo containing?-displayof fenêtre? rootX rootY
    winfo depth fenêtre
    winfo exists fenêtre
    winfo fpixels fenêtre numéro
    winfo geometry fenêtre
    winfo height fenêtre
    winfo id fenêtre
    winfo interps ?-displayof fenêtre?
    winfo ismapped fenêtre
    winfo manager fenêtre
    winfo name fenêtre
    winfo parent fenêtre
    winfo pathname ?-displayof fenêtre? id
    winfo pixels fenêtre numéro
    winfo pointerx fenêtre
    winfo pointerxy fenêtre
    winfo pointery fenêtre
    winfo reqheight fenêtre
    winfo reqwidth fenêtre
    winfo rgb fenêtre color
    winfo rootx fenêtre
    winfo rooty fenêtre
    winfo screen fenêtre
    winfo screencells fenêtre
    winfo screendepth fenêtre
    winfo screenheight fenêtre
    winfo screenmmheight fenêtre
    winfo screenmmwidth fenêtre
    winfo screenvisual fenêtre
    winfo screenwidth fenêtre
    winfo server fenêtre
    winfo toplevel fenêtre
    winfo viewable fenêtre
    winfo visual fenêtre
    winfo visualid fenêtre
    winfo visualsavailable fenêtre ?includeids?
    winfo vrootheight fenêtre
    winfo vrootwidth fenêtre
    winfo vrootx fenêtre
    winfo vrooty fenêtre
    winfo width fenêtre
    winfo x fenêtre
    winfo y fenêtre
  MOTS-CLES

### NOM

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 children fenê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 Tk_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 refèrent à l'écran contenant fenêtre; autrement ils se refè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 exists fenê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 Tk_GetScreenMM, comme ``2.0c'' ou ``1i''. La valeur de retour peut être fractionelle; pour une valeur entière, utilisez winfo pixels.

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

winfo height fenê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, appelezupdate 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 id fenêtre
  Retourne une chaîne hexadécimale indiquant un identificateur de bas niveau spécifique à la plateforme 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 text, 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 Tk_GetPixels, comme ``2.0c'' ou ``1i''. Le résultat est arrondi à la valeur entière la plus proche; pour un résultat fractionnnel, 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éometrie.

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éometrie.

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 plateforme à plateforme. Pour les serveurs X la chaîne a la forme``X major R minor vendor vendorVersion'' où major 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).

### MOTS-CLES

atom, children, class, geometry, hauteur, identificateur, information, interpreters, mapped, parent, nom de chemin, screen, virtuel root, width, fenêtre

    Copyright © 1990-1994 The Regents of the University of California.
    Copyright © 1994-1997 Sun Microsystems, Inc.
    Copyright © 1995-1997 Roger E. Critchlow Jr.

Copyright © 2003 - Le Portail Tcl/Tk Francophone.