frame

 

frame - Crée et manipule un widget frame


SYNTAXE


 frame pathName  ?options?

OPTIONS STANDARD


 -borderwidth ou -bd
 -cursor
 -highlightbackground
 -highlightcolor
 -highlightthickness
 -padx
 -pady
 -relief
 -takefocus

OPTIONS SPÉCIFIQUES 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 pas d'arrière plan ou de bordure, et aucunes couleurs ne seront utilisées de sa colormap pour son arrière plan et sa bordure.

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

Command-Line Name: -colormap Database Name: colormap Database Class: Colormap Spécifie une colormap à utiliser pour la fenêtre. La valeur peut être soit new, auquel cas une nouvelle colormap est créée pour la fenêtre et ses enfants, soit le nom d'une autre fenêtre (qui doit être sur le même écran et avoir le même visuel que pathName), auquel cas la nouvelle fenêtre utilisera la colormap de la fenêtre spécifiée. Si l'option colormap n'est pas spécifiée, la nouvelle fenêtre utilise la même colormap que ses parents. Cette option n'est pas modifiable avec la commande configure.

Command-Line Name: -container Database Name: container Database Class: Container La valeur doit être un booléen. Si vrai, cela 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 opérations comme les requêtes géométriques. La fenêtre ne doit pas avoir d'enfants dans cette application. Cette option n'est pas modifiable avec la commande configure.

Command-Line Name: -height Database Name: height Database Class: Height Spécifie la hauteur désirée pour la fenêtre sous n'importe quelle forme acceptable par GetPixels. Si cette option est inférieure ou égal à zero alors la fenêtre ne demandera aucune taille.

Command-Line Name: -visual Database Name: visual Database Class: Visual Spécifie l'information visuelle pour la nouvelle fenêtre sous n'importe quelle forme acceptable par GetVisual. Si cette option n'est pas spécifiée, la nouvelle fenêtre utilisera le même visuel que ses parents. L'option visual n'est pas modifiable avec la commande configure.

Command-Line Name: -width Database Name: width Database Class: Width Spécifie la largeur désirée pour la fenêtre sous n'importe quelle forme acceptable par GetPixels. Si cette option est inférieure ou égal à zéro alors la fenêtre ne demandera aucune taille.


DESCRIPTION


La commande frame crée une nouvelle fenêtre (indiquée par l'argument pathName ) et en fait un widget frame. Des options supplémentaires, décrites ci-dessus, peuvent être spécifiées sur la ligne de commande ou dans la base de données d'options pour configurer des aspects de la frame comme ses couleurs d'arrière-plan et reliefs. La commande frame retourne le chemin de la nouvelle fenêtre.

Une frame est un widget simple. Son premier usage est d'agir comme séparateur ou conteneur pour des arrangements de fenêtre complexes . Les seules fonctionnalités d'une frame sont ses couleur d'arrière-plan et une bordure 3-D optionnelle pour lui donner une apparence élevée ou enfoncée.


COMMANDES DE WIDGET


La commande frame crée une nouvelle commande Tcl dont le nom est le même que le nom de chemin de la fenêtre de la frame. 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 de la frame. Option et args déterminent le comportement exact de la commande. les commandes suivantes sont admises pour les widgets frame :

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

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 des informations sur le format de cette liste). Si option est spécifiée sans valeur, alors la commande retourne une liste décrivant l'option (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 modifie l'option(s) donnée(s) à valeur(s); dans ce cas la commande retourne une chaîne vide. Option peut prendre n'importe quelle des valeurs acceptées par la commande frame .


BINDINGS


Quand une nouvelle frame est créée, elle n'a pas de bindings d’événement par défaut: les frames 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