toplevel

 

toplevel - Crée et manipule les widgets toplevel


SYNTAXE

 toplevel pathName ?options?

OPTIONS STANDARD


 -borderwidth
 -cursor
 -highlightbackground
 -highlightcolor
 -highlightthickness
 -relief
 -takefocus

OPTIONS SPECIFIQUES AU WIDGET


Command-Line Name: -background Database Name: background Database Class: Background Cette option est la même que l'option standard background excepté que sa valeur peut être également spécifiée comme une chaîne vide. Dans ce cas, le widget n'affichera rien comme arrière-plan ou bordure, et aucunes couleurs ne seront utilisées de sa palette pour son arrière-plan ou sa bordure

Command-Line Name: -class Database Name: class Database Class: Class Indique la classe de la fenêtre. Cette classe sera utilisée pendant l'interrogation de la base de données d'options de la la fenêtres, et sera aussi utilisée plus tard pour d'autres usages comme les bindings. L'option class ne sera pas modifiée avec la commande widget configure.

Command-Line Name: -colormap Database Name: colormap Database Class: Colormap Spécifie la palette à utiliser pour la fenêtre. La valeur peut être soit new, auquel cas une nouvelle palette est créée pour la fenêtre et ses enfants, ou le nom d'une autre fenêtre (qui doivent être sur le même écran et ont les même visuels que pathName), auquel cas la nouvelle fenêtre utilisera la palette de la fenêtre indiquée. Si l'option colormap n'est pas indiquée, la nouvelle fenêtre utilise par défaut la palette de l'écran. Cette option ne sera pas modifiée avec la commande widget configure.

Command-Line Name: -container Database Name: container Database Class: Container La valeur doit être un booléen. Si vrai, il signifie que cette fenêtre sera utilisée comme container dans lequel une autre application sera incorporée (par exemple, une toplevel Tk peut être incorporée en utilisant l'option -use). La fenêtre supportera les protocoles de gestionnaire de fenêtres appropriés pour les appels de fonctions géométriques. La fenêtre ne doit pas avoir d'enfants dans cette application. Cette option ne sera pas modifiée avec la commande widget configure.

Command-Line Name: -hauteur Database Name: hauteur Database Class: Height Indique la hauteur désirée de la fenêtre sous n'importe quelle des formes acceptable par GetPixels. Si cette option est inférieure ou égale à zéro alors la fenêtre ne demande aucune taille.

Command-Line Name: -menu Database Name: menu Database Class: menu Spécifie un widget menu à utiliser comme barre de menu. Sur Macintosh, la barre de menu sera affichée en haut du moniteur principal. Sous Microsoft Windows et toutes les plates-formes UNIX, le menu apparaîtra en haut de la fenêtre comme une partie de l'habillage de la fenêtre géré par le gestionnaire de fenêtres.

Command-Line Name: -screen Database Name: Database Class: Spécifie l'écran sur lequel placer la nouvelle fenêtre. N'importe quel nom d'écran valide peut être utilisé, même un associé à un écran différent. Par défaut le même écran que son parent. Cette option est spéciale dans le sens ou elle ne peut être indiquée via la base de données d'options, et ne peut être modifiée avec la commande widget configure.

Command-Line Name: -use Database Name: use Database Class: Use Cette option est utilisée pour l'incorporation. Si la valeur n'est pas une chaîne vide, ce doit être l'identificateur de fenêtre d'une fenêtre container, spécifié en tant que chaîne hexadécimale identique à celle retournée par la commande winfo. Le widget toplevel sera créé comme un enfant du container donné à la place de la fenêtre racine de l'écran. Si la fenêtre container est dans une application Tk, ce doit être un cadre ou un widget toplevel pour lequel l'option -container a été indiquée. Cette option ne sera pas modifiée avec la commande widget configure.

Command-Line Name: -visual Database Name: visual Database Class: Visual Spécifie l'information visuelle de la nouvelle fenêtre sous n'importe quelle des formes acceptées par GetVisual. Si cette option n'est pas spécifiée, la nouvelle fenêtre utilisera le visuel par défaut de l'écran. L'option visual ne sera pas modifiée avec la commande widget configure.

Command-Line Name: -width Database Name: width Database Class: Width Spécifie la largeur désirée for la fenêtre sous n'importe quelle des formes acceptables par GetPixels. Si cette option est inférieure ou égale à zéro alors la fenêtre ne demande aucune taille.


DESCRIPTION


La commande toplevel crée un nouveau widget toplevel (indiqué par l' argumentpathName ). Des options supplémentaires, décrites ci-dessus, peuvent être spécifié sur la ligne de commande ou dans la base de données d'options pour configurer les aspects de la toplevel comme ses couleur d'arrière-plan et son relief. La commande toplevel retourne le nom de chemin de la nouvelle fenêtre.

Une toplevel est identique à un cadre excepté qu'elle est créée comme fenêtre top-level: son parent X est la fenêtre racine d'un écran plutot que le parent logique de son nom de chemin. L'usage premier d'une toplevel est de servir de container pour les boite de dialogues et autres collections de widgets. Les seules fonctionnalités visibles d'une toplevel sont ses couleur d'arrière-plan et une bordure 3-D optionnelle pour la faire apparaître surélevée ou enfoncée.


COMMANDES DE WIDGET


La commande toplevel crée une nouvelle commande Tcl dont le nom est le même que le nom de chemin de la fenêtre toplevel. Cette commande peut être utilisée pour appeler diverses opérations sur le widget. Elle a la forme générale suivante:

 ''pathName option ''?''arg arg ...''?

PathName est le nom de la commande, qui est le même que le nom de chemin du widget. Option et args déterminent le comportement exact de la commande. Les commandes suivantes sont possible pour les widgets toplevel:

pathName cget option Retourne la valeur courante de l'option de configuration donnée par option. Option peut prendre n'importe quelle des valeurs acceptées par la commande toplevel.

pathName configure ?option? ?valeur option valeur ...? Interroge ou modifie les options de configuration du widget. Si aucune option n'est spécifiée, retourne une liste décrivant toutes les options disponibles pour pathName (voir ConfigWidg pour une information sur le format de cette liste). Si option est spécifiée sans valeur, alors la commande retourne une liste décrivant l'option en question(cette liste sera identique à la correspondante sous-liste de la valeur retournée si aucune option n'est spécifiée). Si une ou plusieurs paires option-valeur sont spécifiées, alors la commande positionne les option(s) donnée(s) aux valeur(s) données; dans ce cas la commande retourne une chaîne vide. Option peut prendre n'importe quelle des valeurs acceptées par la commande toplevel.


BINDINGS


Quand une nouvelle toplevel est créée, elle n'a pas de bindings d’événement par défaut: les toplevels ne sont pas conçues pour être interactives.


Traduit par Michel Salvagniac 2002-2003

Copyright © 2003 - Le Wiki Tcl/Tk Francophone.


Catégorie Manuel Tcl/Tk