tkinter.ttk
--- Tk themed widgets¶
Code source : Lib/tkinter/ttk.py
Le module tkinter.ttk
donne accès à l'ensemble de widgets sur le thème Tk, introduit dans Tk 8.5. Il offre des avantages supplémentaires, notamment le rendu des polices avec anticrénelage sous X11 et la transparence des fenêtres (nécessitant un gestionnaire de fenêtres de composition sur X11).
L'idée de base de tkinter.ttk
est de séparer, dans la mesure du possible, le code implémentant le comportement d'un widget du code implémentant son apparence.
Voir aussi
- Tk Widget Styling Support
Document présentant la prise en charge des thèmes pour Tk
Utilisation de Ttk¶
Pour commencer à utiliser Ttk, importez son module :
from tkinter import ttk
Pour remplacer les widgets Tk de base, l'importation doit suivre l'importation Tk :
from tkinter import *
from tkinter.ttk import *
Ce code implique que plusieurs widgets tkinter.ttk
(Button
, Checkbutton
, Entry
, Frame
, Label
, LabelFrame
, Menubutton
, PanedWindow
, Radiobutton
, Scale
et Scrollbar
) remplacent automatiquement les widgets Tk.
L'avantage immédiat est d'utiliser les nouveaux widgets qui donnent une meilleure apparence sur toutes les plateformes ; cependant, les widgets de remplacement ne sont pas complètement compatibles. La principale différence est que les options de widget telles que "fg"
, "bg"
et d'autres liées au style des widgets ne sont plus présentes dans les widgets Ttk. Utilisez plutôt la classe ttk.Style
pour des effets de style améliorés.
Voir aussi
- Converting existing applications to use Tile widgets
Monographie (utilisant la terminologie Tcl) sur les différences généralement rencontrées lors de la modification d'applications pour utiliser les nouveaux widgets.
Widgets Ttk¶
Ttk est livré avec 18 widgets, dont douze existaient déjà dans tkinter : Button
, Checkbutton
, Entry
, Frame
, Label
, LabelFrame
, Menubutton
, PanedWindow
, Radiobutton
, Scale
, Scrollbar
et Spinbox
. Les six autres sont nouveaux : Combobox
, Notebook
, Progressbar
, Separator
, Sizegrip
et Treeview
. Et tous sont des sous-classes de Widget
.
L'utilisation des widgets Ttk donne à l'application une apparence et une convivialité améliorées. Comme indiqué ci-dessus, il existe des différences dans la façon dont le style est codé.
Code Tk :
l1 = tkinter.Label(text="Test", fg="black", bg="white")
l2 = tkinter.Label(text="Test", fg="black", bg="white")
Code Ttk :
style = ttk.Style()
style.configure("BW.TLabel", foreground="black", background="white")
l1 = ttk.Label(text="Test", style="BW.TLabel")
l2 = ttk.Label(text="Test", style="BW.TLabel")
Pour plus d'informations sur TtkStyling, consultez la documentation de la classe Style
.
Widget¶
ttk.Widget
définit les options et méthodes standard prises en charge par les widgets à thème Tk et n'est pas censé être directement instancié.
Options standards¶
All the ttk
Widgets accept the following options:
Option |
Description |
---|---|
class |
Spécifie la classe de fenêtre. La classe est utilisée lors de l'interrogation de la base de données d'options pour les autres options de la fenêtre, pour déterminer les balises de liaison par défaut pour la fenêtre et pour sélectionner la disposition et le style par défaut du widget. Cette option est en lecture seule et ne peut être spécifiée qu'à la création de la fenêtre. |
cursor |
Spécifie le curseur de la souris à utiliser pour le widget. S'il est défini sur la chaîne vide (valeur par défaut), le curseur est hérité du widget parent. |
takefocus |
Détermine si la fenêtre accepte le focus pendant le parcours du clavier. 0, 1 ou une chaîne vide est renvoyée. Si 0 est renvoyé, cela signifie que la fenêtre doit être entièrement ignorée lors du parcours au clavier. Si 1, cela signifie que la fenêtre doit recevoir le focus d'entrée tant qu'elle est visible. Et une chaîne vide signifie que les scripts de parcours prennent la décision de donner ou non le focus à la fenêtre. |
style |
Peut être utilisé pour spécifier un style de widget personnalisé. |
Options de widget avec barre de défilement¶
Les options suivantes sont prises en charge par les widgets contrôlés par une barre de défilement.
Option |
Description |
---|---|
xscrollcommand |
Utilisé pour communiquer avec les barres de défilement horizontal. Lorsque la vue dans la fenêtre du widget change, le widget génère une commande Tcl basée sur scrollcommand. Habituellement, cette option consiste en la méthode |
yscrollcommand |
Utilisé pour communiquer avec les barres de défilement vertical. Pour plus d'informations, voir ci-dessus. |
Options d'étiquette (label)¶
Les options suivantes sont prises en charge par les étiquettes (labels), les boutons et autres widgets de type bouton.
Option |
Description |
---|---|
text |
Spécifie une chaîne de texte à afficher dans le widget. |
textvariable |
Spécifie un nom dont la valeur est utilisée à la place de la ressource d'option de texte. |
underline |
S'il est défini, spécifie l'indice (commençant à 0) d'un caractère à souligner dans la chaîne de texte. Le caractère de soulignement est utilisé pour l'activation mnémonique. |
image |
Spécifie une image à afficher. C'est une liste de un ou plusieurs éléments. Le premier élément est le nom de l'image par défaut. Le reste de la liste est une séquence de paires statespec-valeur telles que définies par |
compound |
Spécifie comment afficher l'image par rapport au texte, dans le cas où les options de texte et d'images sont présentes. Les valeurs valides sont :
|
width |
Si supérieur à zéro, spécifie la quantité d'espace, en largeurs de caractères, à allouer à l'étiquette de texte, si inférieur à zéro, spécifie une largeur minimale. Si zéro ou non spécifié, la largeur naturelle de l'étiquette de texte est utilisée. |
Options de compatibilité¶
Option |
Description |
---|---|
state |
Peut être défini sur |
États des widgets¶
L'état du widget est une combinaison d'indicateurs d'état indépendants.
Option |
Description |
---|---|
active |
Le curseur de la souris est sur le widget et appuyer sur un bouton de la souris provoquera une action |
disabled |
Le widget est désactivé sous le contrôle du programme |
focus |
Le widget a le focus du clavier |
pressed |
Le widget est en train d'être pressé |
selected |
|
background |
Windows et Mac ont une notion de fenêtre « active » ou de premier plan. L'état background est défini pour les widgets dans une fenêtre en arrière-plan et effacé pour ceux de la fenêtre au premier plan |
readonly |
Le widget ne doit pas permettre la modification par l'utilisateur |
alternate |
Un format d'affichage alternatif spécifique au widget |
invalid |
La valeur du widget est invalide |
Une spécification d'état est une séquence de noms d'état, éventuellement précédée d'un point d'exclamation indiquant que le bit est désactivé.
ttk.Widget¶
Outre les méthodes décrites ci-dessous, la ttk.Widget
prend en charge les méthodes tkinter.Widget.cget()
et tkinter.Widget.configure()
.
- class tkinter.ttk.Widget¶
- identify(x, y)¶
Renvoie le nom de l'élément à la position x y, ou la chaîne vide si le point ne se trouve dans aucun élément.
x et y sont des coordonnées en pixels relatives au widget.
- instate(statespec, callback=None, *args, **kw)¶
Teste l'état du widget. Si un rappel n'est pas spécifié, renvoie
True
si l'état du widget correspond à statespec etFalse
sinon. Si le rappel est spécifié, il est appelé avec des arguments si l'état du widget correspond à statespec.
- state(statespec=None)¶
Modifie ou demande l'état du widget. Si statespec est spécifié, définit l'état du widget en fonction de celui-ci et renvoie un nouveau statespec indiquant quels drapeaux ont été modifiés. Si statespec n'est pas spécifié, renvoie les indicateurs d'état actuellement activés.
statespec est généralement une liste ou un n-uplet.
Combobox¶
Le widget ttk.Combobox
combine un champ de texte avec une liste déroulante de valeurs. Ce widget est une sous-classe de Entry
.
En plus des méthodes héritées de Widget
: Widget.cget()
, Widget.configure()
, Widget.identify()
, Widget.instate()
et Widget.state()
, et les suivants hérités de Entry
: Entry.bbox()
, Entry.delete()
, Entry.icursor()
, Entry.index()
, Entry.insert()
, Entry.selection()
, Entry.xview()
, il a quelques autres méthodes, décrites dans ttk.Combobox
.
Options¶
Ce widget accepte les options spécifiques suivantes :
Option |
Description |
---|---|
exportationsselection |
Valeur booléenne. Si elle est définie, la sélection du widget est liée à la sélection du gestionnaire de fenêtres (qui peut être renvoyée en appelant Misc.selection_get, par exemple). |
justify |
Spécifie comment le texte est aligné dans le widget. Les valeurs possibles sont |
height |
Spécifie la hauteur de la liste déroulante, en lignes. |
postcommand |
Script (éventuellement enregistré avec Misc.register) qui est appelé immédiatement avant d'afficher les valeurs. Il peut spécifier les valeurs à afficher. |
state |
Les valeurs sont |
textvariable |
Spécifie un nom dont la valeur est liée à la valeur du widget. Chaque fois que la valeur associée à ce nom change, la valeur du widget est mise à jour, et vice versa. Voir |
values |
Spécifie la liste de valeurs à afficher dans la liste déroulante. |
width |
Spécifie une valeur entière indiquant la largeur souhaitée de la fenêtre d'entrée, en caractères de taille moyenne de la police du widget. |
Événements virtuels¶
Les widgets combobox génèrent un événement virtuel <<ComboboxSelected>> lorsque l'utilisateur sélectionne un élément dans la liste de valeurs.
ttk.Combobox¶
- class tkinter.ttk.Combobox¶
- current(newindex=None)¶
Si newindex est spécifié, définit la valeur de la combobox à la position de l'élément newindex. Sinon, renvoie l'indice de la valeur courante ou −1 si la valeur courante n'est pas dans la liste des valeurs.
- get()¶
Renvoie la valeur actuelle de la combobox.
- set(value)¶
Définit la valeur de la combobox sur value.
Spinbox¶
Le widget ttk.Spinbox
est un ttk.Entry
amélioré avec des flèches d'incrémentation et de décrémentation. Il peut être utilisé pour des nombres ou des listes de valeurs de chaîne. Ce widget est une sous-classe de Entry
.
En plus des méthodes héritées de Widget
: Widget.cget()
, Widget.configure()
, Widget.identify()
, Widget.instate()
et Widget.state()
, et les suivantes héritées de Entry
: Entry.bbox()
, Entry.delete()
, Entry.icursor()
, Entry.index()
, Entry.insert()
, Entry.xview()
, il a quelques autres méthodes, décrites dans ttk.Spinbox
.
Options¶
Ce widget accepte les options spécifiques suivantes :
Option |
Description |
---|---|
from |
Valeur flottante. Si elle est définie, il s'agit de la valeur minimale à laquelle le bouton de décrémentation décrémentera. Doit être orthographié comme |
to |
Valeur flottante. Si elle est définie, il s'agit de la valeur maximale du bouton d'incrémentation. |
increment |
Valeur flottante. Spécifie la quantité dont les boutons d'incrémentation/décrémentation modifient la valeur. La valeur par défaut est 1.0. |
values |
Séquence de valeurs de chaîne ou flottantes. S'ils sont spécifiés, les boutons d'incrémentation/décrémentation font défiler les éléments dans cette séquence plutôt que d'incrémenter ou de décrémenter les nombres. |
wrap |
Valeur booléenne. Si |
format |
Valeur sous forme de chaîne. Cela spécifie le format des nombres définis par les boutons d'incrémentation/décrémentation. Il doit être sous la forme |
command |
appelable Python. Est appelé sans argument chaque fois que l'un des boutons d'incrémentation ou de décrémentation est enfoncé. |
Événements virtuels¶
Le widget spinbox génère un événement virtuel <<Increment>> lorsque l'utilisateur appuie sur <Up>, et un événement virtuel <<Decrement>> lorsque l'utilisateur appuie sur <Down>.
ttk.Spinbox¶
Carnet de notes (notebook)¶
Le widget Ttk Notebook gère une collection de fenêtres et n'en affiche qu'une seule à la fois. Chaque fenêtre enfant est associée à un onglet, que l'utilisateur peut sélectionner pour changer la fenêtre actuellement affichée.
Options¶
Ce widget accepte les options spécifiques suivantes :
Option |
Description |
---|---|
height |
S'il est présent et supérieur à zéro, spécifie la hauteur souhaitée de la zone du volet (sans compter l'ajustement interne ni les onglets). Sinon, la hauteur maximale de tous les volets est utilisée. |
padding |
Spécifie la quantité d'espace supplémentaire à ajouter autour de l'extérieur du bloc-notes. L'ajustement est défini par une liste jusqu'à quatre spécifications de longueur à gauche en haut à droite en bas. Si moins de quatre éléments sont spécifiés, bottom vaut par défaut top, right vaut par défaut left et top vaut par défaut left. |
width |
S'il est présent et supérieur à zéro, spécifiez la largeur souhaitée de la zone du volet (hors ajustement interne). Sinon, la largeur maximale de tous les volets est utilisée. |
Options d'onglet¶
Il existe également des options spécifiques pour les onglets :
Option |
Description |
---|---|
state |
Soit |
sticky |
Spécifie comment la fenêtre enfant est positionnée dans la zone du volet. La valeur est une chaîne contenant zéro ou plusieurs des caractères "n", "s", "e" ou "w". Chaque lettre fait référence à un côté (nord, sud, est ou ouest) auquel la fenêtre enfant colle, selon le gestionnaire de géométrie |
padding |
Spécifie la quantité d'espace supplémentaire à ajouter entre le bloc-notes et ce volet. La syntaxe est la même que pour l'option d'ajustement utilisée par ce widget. |
text |
Spécifie un texte à afficher dans l'onglet. |
image |
Spécifie une image à afficher dans l'onglet. Voir l'option image décrite dans |
compound |
Spécifie comment afficher l'image par rapport au texte, dans le cas où les deux options texte et image sont présentes. Voir Label Options pour les valeurs autorisées. |
underline |
Spécifie l'indice (en commençant à 0) d'un caractère à souligner dans la chaîne de texte. Le caractère souligné est utilisé pour l'activation mnémonique si |
Identifiants d'onglet¶
Le tab_id présent dans plusieurs méthodes de ttk.Notebook
peut prendre l'une des formes suivantes :
Un entier compris entre zéro et le nombre d'onglets
Le nom d'une fenêtre fille
Une spécification de position de la forme "@x,y", qui identifie l'onglet
La chaîne littérale
"current"
, qui identifie l'onglet actuellement sélectionnéLa chaîne littérale
"end"
, qui renvoie le nombre d'onglets (valable uniquement pourNotebook.index()
)
Événements virtuels¶
Ce widget génère un événement virtuel <<NotebookTabChanged>> après la sélection d'un nouvel onglet.
ttk.Notebook¶
- class tkinter.ttk.Notebook¶
- add(child, **kw)¶
Ajoute un nouvel onglet au bloc-notes.
Si la fenêtre est actuellement gérée par le notebook mais masquée, elle est restaurée à sa position précédente.
Voir Options d'onglet pour la liste des options disponibles.
- forget(tab_id)¶
Supprime l'onglet spécifié par tab_id, et ne gère plus la fenêtre associée.
- hide(tab_id)¶
Masque l'onglet spécifié par tab_id.
L'onglet ne s'affiche pas, mais la fenêtre associée reste gérée par le notebook et sa configuration mémorisée. Les onglets cachés peuvent être restaurés avec la commande
add()
.
- identify(x, y)¶
Renvoie le nom de l'élément tab à la position x, y, ou la chaîne vide s'il n'y en a pas.
- index(tab_id)¶
Renvoie l'indice de l'onglet spécifié par tab_id, ou le nombre total d'onglets si tab_id est la chaîne
"end"
.
- insert(pos, child, **kw)¶
Insère un volet à la position spécifiée.
pos est soit la chaîne
"end"
, un indice entier ou le nom d'un enfant géré. Si child est déjà géré par le notebook, le déplace vers la position spécifiée.Voir Options d'onglet pour la liste des options disponibles.
- select(tab_id=None)¶
Sélectionne le tab_id spécifié.
La fenêtre enfant associée est affichée, et la fenêtre précédemment sélectionnée (si différente) est masquée. Si tab_id est omis, renvoie le nom du widget du volet actuellement sélectionné.
- tab(tab_id, option=None, **kw)¶
Interroge ou modifie les options du tab_id spécifique.
Si kw n'est pas donné, renvoie un dictionnaire des valeurs des options de l'onglet. Si option est spécifié, renvoie la valeur de cette option. Sinon, définit les options sur les valeurs correspondantes.
- tabs()¶
Renvoie une liste des fenêtres gérées par le notebook.
- enable_traversal()¶
Active la traversée du clavier pour une fenêtre de niveau supérieur contenant ce bloc-notes.
Cela étend les liaisons pour la fenêtre de niveau supérieur contenant le bloc-notes comme suit :
Control-Tab : sélectionne l'onglet suivant celui actuellement sélectionné.
Shift-Control-Tab : sélectionne l'onglet précédant celui actuellement sélectionné.
Alt-K : où K est le caractère mnémonique (souligné) de n'importe quel onglet, sélectionne cet onglet.
Plusieurs blocs-notes dans un seul niveau supérieur peuvent être activés pour la traversée, y compris les blocs-notes imbriqués. Cependant, la traversée du bloc-notes ne fonctionne correctement que si tous les volets ont le bloc-notes dans lequel ils se trouvent en tant que maître.
Barre de progression¶
Le widget ttk.Progressbar
affiche l'état d'une opération de longue durée. Il peut fonctionner en deux modes : 1) le mode déterminé qui indique la quantité achevée par rapport à la quantité totale de travail à effectuer et 2) le mode indéterminé qui fournit un affichage animé pour informer l'utilisateur que le travail progresse.
Options¶
Ce widget accepte les options spécifiques suivantes :
Option |
Description |
---|---|
orient |
|
length |
Spécifie la longueur de l'axe long de la barre de progression (largeur si horizontale, hauteur si verticale). |
mode |
|
maximum |
Nombre spécifiant la valeur maximale. La valeur par défaut est 100. |
value |
La valeur actuelle de la barre de progression. En mode determinate, cela représente la quantité de travail accompli. En mode indeterminate, il est interprété comme modulo maximum ; c'est-à-dire que la barre de progression effectue un « cycle » lorsque sa valeur augmente de maximum. |
variable |
Nom lié à la valeur de l'option. Si spécifié, la valeur de la barre de progression est automatiquement fixée à la valeur de ce nom à chaque modification de ce dernier. |
phase |
Option en lecture seule. Le widget incrémente périodiquement la valeur de cette option chaque fois que sa valeur est supérieure à 0 et, en mode déterminate, inférieure au maximum. Cette option peut être utilisée par le thème actuel pour fournir des effets d'animation supplémentaires. |
ttk.Progressbar¶
- class tkinter.ttk.Progressbar¶
- start(interval=None)¶
Commence le mode d'auto-incrémentation : planifie un événement de minuterie récurrent qui appelle
Progressbar.step()
toutes les interval millisecondes. S'il est omis, interval est par défaut de 50 millisecondes.
- step(amount=None)¶
Incrémente la valeur de la barre de progression de amount.
amount est par défaut égal à
1.0
s'il est omis.
- stop()¶
Arrête le mode d'auto-incrémentation : annule tout événement de minuterie récurrent initié par
Progressbar.start()
pour cette barre de progression.
Séparateur¶
Le widget ttk.Separator
affiche une barre de séparation horizontale ou verticale.
Il n'a pas d'autres méthodes que celles héritées de ttk.Widget
.
Options¶
Ce widget accepte l'option spécifique suivante :
Option |
Description |
---|---|
orient |
|
Poignée de redimensionnement¶
Le widget ttk.Sizegrip
(également connu sous le nom de grow box) permet à l'utilisateur de redimensionner la fenêtre de niveau supérieur en appuyant et en faisant glisser la poignée.
Ce widget n'a ni options spécifiques ni méthodes spécifiques, à part celles héritées de ttk.Widget
.
Notes spécifiques à une plateforme¶
Sur macOS, les fenêtres de niveau supérieur incluent automatiquement une poignée de redimensionnement intégrée par défaut. L'ajout d'un
Sizegrip
est sans danger, car la poignée intégrée masquera simplement le widget.
Bogues¶
Si la position du contenant de niveau supérieur a été spécifiée par rapport à la droite ou au bas de l'écran (par exemple…), le widget
Sizegrip
ne redimensionne pas la fenêtre.Ce widget ne prend en charge que le redimensionnement
"southeast"
.
Arborescence¶
Le widget ttk.Treeview
affiche une collection hiérarchique d'éléments. Chaque élément possède une étiquette textuelle, une image facultative et une liste facultative de valeurs de données. Les valeurs des données sont affichées dans des colonnes successives après l'étiquette de l'arbre.
L'ordre dans lequel les valeurs de données sont affichées peut être contrôlé en définissant l'option de widget displaycolumns
. Le widget d'arborescence peut également afficher les en-têtes de colonne. Les colonnes sont accessibles par des numéros ou des noms symboliques indiqués dans l'option columns du widget. Voir Identifiants de colonnes.
Chaque élément est identifié par un nom unique. Le widget génère des identifiants d'éléments s'ils ne sont pas fournis par l'appelant. Il existe un élément racine distinct, nommé {}
. L'élément racine lui-même n'est pas affiché ; ses enfants apparaissent au niveau supérieur de la hiérarchie.
Chaque élément possède également une liste de balises, qui peuvent être utilisées pour associer des liaisons d'événements à des éléments individuels et contrôler l'apparence de l'élément.
Le widget Treeview prend en charge le défilement horizontal et vertical, selon les options décrites dans Scrollable Widget Options et les méthodes Treeview.xview()
et Treeview.yview()
.
Options¶
Ce widget accepte les options spécifiques suivantes :
Option |
Description |
---|---|
columns |
Une liste d'identificateurs de colonne, spécifiant le nombre de colonnes et leurs noms. |
displaycolumns |
Une liste d'identificateurs de colonne (indices symboliques ou entiers) spécifiant quelles colonnes de données sont affichées et l'ordre dans lequel elles apparaissent, ou la chaîne |
height |
Spécifie le nombre de lignes qui doivent être visibles. Remarque : la largeur demandée est déterminée à partir de la somme des largeurs de colonne. |
padding |
Spécifie le remplissage interne du widget. L'ajustement est décrit par une liste jusqu'à quatre spécifications de longueur. |
selectmode |
Contrôle la façon dont les liaisons de classe intégrées gèrent la sélection. Les valeurs possibles sont Notez que le code d'application et les liaisons de balises peuvent définir la sélection comme ils le souhaitent, quelle que soit la valeur de cette option. |
show |
Une liste contenant zéro ou plusieurs des valeurs suivantes, spécifiant les éléments de l'arborescence à afficher.
La valeur par défaut est Remarque : la colonne 0 fait toujours référence à la colonne de l'arborescence, même si |
Options d'éléments¶
Les options d'éléments suivantes peuvent être spécifiées pour les éléments dans les commandes insert et les widgets de type élément.
Option |
Description |
---|---|
text |
Libellé textuel à afficher pour l'élément. |
image |
Image Tk, affichée à gauche de l'étiquette. |
values |
Liste des valeurs associées à l'élément. Chaque élément doit avoir le même nombre de valeurs que les colonnes d'options du widget. S'il y a moins de valeurs que de colonnes, les valeurs restantes sont supposées vides. S'il y a plus de valeurs que de colonnes, les valeurs supplémentaires sont ignorées. |
open |
Valeur |
tags |
Liste de balises associées à cet élément. |
Options de balise¶
Les options suivantes peuvent être spécifiées sur les balises :
Option |
Description |
---|---|
foreground |
Spécifie la couleur de premier plan du texte. |
background |
Spécifie la couleur d'arrière-plan de la cellule ou de l'élément. |
font |
Spécifie la police à utiliser lors du dessin du texte. |
image |
Spécifie l'image de l'élément, au cas où l'option d'image de l'élément est vide. |
Identifiants de colonnes¶
Les identifiants de colonnes prennent l'une des formes suivantes :
Un nom symbolique de l'option de liste de colonnes.
Un entier n, spécifiant la nième colonne de données.
Une chaîne de la forme #n, où n est un entier, spécifiant la nième colonne d'affichage.
Notes :
Les valeurs d'option de l'élément peuvent être affichées dans un ordre différent de celui dans lequel elles sont stockées.
La colonne #0 fait toujours référence à la colonne de l'arborescence, même si
show="tree"
n'est pas spécifié.
Un numéro de colonne de données est un indice dans la liste des valeurs d'option d'un élément ; un numéro de colonne d'affichage est le numéro de colonne dans l'arborescence où les valeurs sont affichées. Les étiquettes d'arbre sont affichées dans la colonne #0. Si l'option displaycolumns n'est pas définie, la colonne de données n s'affiche dans la colonne #n+1. Encore une fois, la colonne #0 fait toujours référence à la colonne de l'arborescence.
Événements virtuels¶
Le widget Treeview génère les événements virtuels suivants.
Événement |
Description |
---|---|
<<TreeviewSelect>> |
Généré chaque fois que la sélection change. |
<<TreeviewOpen>> |
Généré juste avant de définir l'élément de focus sur |
<<TreeviewClose>> |
Généré juste après avoir défini l'élément de focus sur |
Les méthodes Treeview.focus()
et Treeview.selection()
peuvent être utilisées pour déterminer le ou les éléments concernés.
ttk.Treeview¶
- class tkinter.ttk.Treeview¶
- bbox(item, column=None)¶
Renvoie la boîte englobante (relative à la fenêtre du widget treeview) de l'item spécifié sous la forme (x, y, largeur, hauteur).
Si column est spécifié, renvoie la boîte englobante de cette cellule. Si item n'est pas visible (c'est-à-dire s'il est un descendant d'un élément fermé ou se trouve hors écran en raison du défilement), renvoie une chaîne vide.
- get_children(item=None)¶
Renvoie la liste des enfants appartenant à item.
Si item n'est pas spécifié, renvoie les enfants racine.
- set_children(item, *newchildren)¶
Remplace l'enfant de item par newchildren.
Les enfants présents dans item qui ne sont pas présents dans newchildren sont détachés de l'arbre. Aucun élément de newchildren ne peut être un ancêtre de item. Notez que ne pas spécifier newchildren entraîne le détachement des enfants de item.
- column(column, option=None, **kw)¶
Interroge ou modifie les options pour la column spécifiée.
Si kw n'est pas donné, renvoie un dictionnaire des valeurs d'option de colonne. Si option est spécifié, la valeur de cette option est renvoyée. Sinon, définit les options sur les valeurs correspondantes.
Les options/valeurs valides sont :
- id
Renvoie le nom de la colonne. Il s'agit d'une option en lecture seule.
- anchor: One of the standard Tk anchor values.
Spécifie comment le texte de cette colonne doit être aligné par rapport à la cellule.
- minwidth: width
La largeur minimale de la colonne en pixels. Le widget Treeview ne rend pas la colonne plus petite que celle spécifiée par cette option lorsque le widget est redimensionné ou que l'utilisateur fait glisser une colonne.
- stretch:
True
/False
Spécifie si la largeur de la colonne doit être ajustée lorsque le widget est redimensionné.
- width: width
La largeur de la colonne en pixels.
Pour configurer la colonne d'arborescence, appelez-la avec
column = "#0"
- delete(*items)¶
Supprime tous les items spécifiés et tous leurs descendants.
L'élément racine ne peut pas être supprimé.
- detach(*items)¶
Dissocie tous les items spécifiés de l'arborescence.
Les éléments et tous leurs descendants sont toujours présents et peuvent être réinsérés à un autre point de l'arborescence, mais ne seront pas affichés.
L'élément racine ne peut pas être détaché.
- exists(item)¶
Renvoie
True
si l'item spécifié est présent dans l'arborescence.
- focus(item=None)¶
Si item est spécifié, définit l'élément de focus sur item. Sinon, renvoie l'élément de focus actuel, ou
''
s'il n'y en a pas.
- heading(column, option=None, **kw)¶
Interroge ou modifie les options d'en-tête pour la column spécifiée.
Si kw n'est pas donné, renvoie un dictionnaire des valeurs d'option d'en-tête. Si option est spécifié, la valeur de cette option est renvoyée. Sinon, définit les options sur les valeurs correspondantes.
Les options/valeurs valides sont :
- text: text
Texte à afficher dans l'en-tête de colonne.
- image: imageName
Spécifie une image à afficher à droite de l'en-tête de colonne.
- anchor: anchor
Spécifie comment le texte du titre doit être aligné. Une des valeurs d'ancrage Tk standard.
- command: callback
Un rappel à invoquer lorsque l'étiquette d'en-tête est pressée.
Pour configurer l'en-tête de colonne de l'arborescence, appelez-la avec
column = "#0"
.
- identify(component, x, y)¶
Renvoie une description du component spécifié sous le point donné par x et y, ou la chaîne vide si aucun component de ce type n'est présent à cette position.
- identify_row(y)¶
Renvoie l'ID d'élément de l'élément à la position y.
- identify_column(x)¶
Renvoie l'identificateur de colonne de données de la cellule à la position x.
La colonne arborescence possède l'ID #0.
- identify_region(x, y)¶
Renvoie l'un des éléments suivants :
region
signification
heading
Zone d'en-tête de l'arbre.
separator
Espace entre deux en-têtes de colonnes.
tree (arbre)
Une zone de l'arbre.
cell
Une cellule de données.
Disponibilité : Tk 8.6.
- identify_element(x, y)¶
Renvoie l'élément à la position x, y.
Disponibilité : Tk 8.6.
- index(item)¶
Renvoie l'indice (entier) de item dans la liste des enfants de son parent.
- insert(parent, index, iid=None, **kw)¶
Crée un nouvel élément et renvoie l'identifiant de l'élément nouvellement créé.
parent est l'ID d'élément de l'élément parent ou la chaîne vide pour créer un nouvel élément de niveau supérieur. index est un entier, ou la valeur
"end"
, spécifiant où dans la liste des enfants du parent insérer le nouvel élément. Si index est inférieur ou égal à zéro, le nouveau nœud est inséré au début ; si index est supérieur ou égal au nombre actuel d'enfants, il est inséré à la fin. Si iid est spécifié, il est utilisé comme identifiant d'élément ; iid ne doit pas déjà exister dans l'arborescence. Sinon, un nouvel identifiant unique est généré.See Item Options for the list of available options.
- item(item, option=None, **kw)¶
Interroge ou modifie les options pour l'item spécifié.
Si aucune option n'est donnée, un dictionnaire avec des options/valeurs pour l'élément est renvoyé. Si option est spécifié, la valeur de cette option est renvoyée. Sinon, définit les options sur les valeurs correspondantes données par kw.
- move(item, parent, index)¶
Déplace item vers la position index dans la liste des enfants de parent.
Il est interdit de déplacer un élément sous l'un de ses descendants. Si index est inférieur ou égal à zéro, item est déplacé au début ; s'il est supérieur ou égal au nombre d'enfants, il est déplacé à la fin. Si item a été détaché, il est rattaché.
- next(item)¶
Renvoie l'identifiant du frère suivant de item, ou
''
si item est le dernier enfant de son parent.
- parent(item)¶
Renvoie l'identifiant du parent de item, ou
''
si item est au niveau supérieur de la hiérarchie.
- prev(item)¶
Renvoie l'identifiant du frère précédent de item, ou
''
si item est le premier enfant de son parent.
- reattach(item, parent, index)¶
Alias pour
Treeview.move()
.
- see(item)¶
Fait en sorte que item soit visible.
Définit l'option d'ouverture de tous les ancêtres de item sur
True
, et fait défiler le widget si nécessaire afin que item soit dans la partie visible de l'arborescence.
- selection()¶
Renvoie un n-uplet d'éléments sélectionnés.
Modifié dans la version 3.8:
selection()
ne prend plus d'arguments. Pour modifier l'état de sélection, utilisez les méthodes de sélection suivantes.
- selection_set(*items)¶
items devient la nouvelle sélection.
Modifié dans la version 3.6: items peut être passé en tant qu'arguments séparés, pas seulement en tant que n-uplet.
- selection_add(*items)¶
Ajoute des items à la sélection.
Modifié dans la version 3.6: items peut être passé en tant qu'arguments séparés, pas seulement en tant que n-uplet.
- selection_remove(*items)¶
Supprime les items de la sélection.
Modifié dans la version 3.6: items peut être passé en tant qu'arguments séparés, pas seulement en tant que n-uplet.
- selection_toggle(*items)¶
Bascule l'état de sélection de chaque élément de items.
Modifié dans la version 3.6: items peut être passé en tant qu'arguments séparés, pas seulement en tant que n-uplet.
- set(item, column=None, value=None)¶
Avec un argument, renvoie un dictionnaire de paires colonne/valeur pour l'item spécifié. Avec deux arguments, renvoie la valeur actuelle de la column spécifiée. Avec trois arguments, définit la valeur de la column donnée dans l'item donné à la value spécifiée.
- tag_bind(tagname, sequence=None, callback=None)¶
Lie le rappel callback à l'événement donné sequence pour la balise tagname. Lorsqu'un événement est envoyé à un élément, les rappels pour chacune des options de balises de l'élément sont appelés.
- tag_configure(tagname, option=None, **kw)¶
Interroge ou modifie les options pour le tagname spécifié.
Si kw n'est pas donné, renvoie un dictionnaire des paramètres d'option pour tagname. Si option est spécifié, renvoie la valeur de cette option pour le tagname spécifié. Sinon, définit les options sur les valeurs correspondantes pour le tagname donné.
- tag_has(tagname, item=None)¶
Si item est spécifié, renvoie 1 ou 0 selon que item spécifié a le tagname donné. Sinon, renvoie une liste de tous les éléments qui ont la balise spécifiée.
Disponibilité : Tk 8.6
- xview(*args)¶
Interroge ou modifie la position horizontale de l'arborescence.
- yview(*args)¶
Interroge ou modifie la position verticale de l'arborescence.
Style Ttk¶
Chaque widget dans ttk
se voit attribuer un style, qui spécifie l'ensemble d'éléments composant le widget et la façon dont ils sont disposés, ainsi que les paramètres dynamiques et par défaut pour les options d'élément. Par défaut, le nom du style est le même que le nom de la classe du widget, mais il peut être remplacé par l'option de style du widget. Si vous ne connaissez pas le nom de classe d'un widget, utilisez la méthode Misc.winfo_class()
(somewidget.winfo_class()).
Voir aussi
- Tcl'2004 conference presentation
Ce document explique le fonctionnement du moteur de thème
- class tkinter.ttk.Style¶
Cette classe est utilisée pour manipuler la base de données de style.
- configure(style, query_opt=None, **kw)¶
Interroge ou définit la valeur par défaut des options spécifiées dans style.
Chaque clé dans kw est une option et chaque valeur est une chaîne identifiant la valeur de cette option.
Par exemple, pour changer chaque bouton par défaut en un bouton plat avec un ajustement et une couleur d'arrière-plan différente :
from tkinter import ttk import tkinter root = tkinter.Tk() ttk.Style().configure("TButton", padding=6, relief="flat", background="#ccc") btn = ttk.Button(text="Sample") btn.pack() root.mainloop()
- map(style, query_opt=None, **kw)¶
Interroge ou définit les valeurs dynamiques des options spécifiées dans style.
Chaque clé dans kw est une option et chaque valeur doit être une liste ou un n-uplet (généralement) contenant des spécifications d'état regroupées dans des n-uplets, des listes ou une autre préférence. Un statespec est un composé d'un ou plusieurs états, puis d'une valeur.
Un exemple peut le rendre plus compréhensible :
import tkinter from tkinter import ttk root = tkinter.Tk() style = ttk.Style() style.map("C.TButton", foreground=[('pressed', 'red'), ('active', 'blue')], background=[('pressed', '!disabled', 'black'), ('active', 'white')] ) colored_btn = ttk.Button(text="Test", style="C.TButton").pack() root.mainloop()
Notez que l'ordre des séquences (états, valeur) pour une option est important, si l'ordre est changé en
[('active', 'blue'), ('pressed', 'red')]
dans l'option de premier plan, par exemple, le résultat est un premier plan bleu lorsque le widget est dans les états actif ou pressé.
- lookup(style, option, state=None, default=None)¶
Renvoie la valeur spécifiée pour option dans style.
Si state est spécifié, on s'attend à ce qu'il s'agisse d'une séquence d'un ou plusieurs états. Si l'argument default est défini, il est utilisé comme valeur de secours au cas où aucune spécification d'option n'est trouvée.
Pour vérifier quelle police un bouton utilise par défaut :
from tkinter import ttk print(ttk.Style().lookup("TButton", "font"))
- layout(style, layoutspec=None)¶
Définit la disposition du widget pour un style donné. Si layoutspec est omis, renvoie la spécification de mise en page pour le style donné.
layoutspec, si spécifié, doit être une liste ou un autre type de séquence (à l'exception des chaînes), où chaque élément doit être un n-uplet et le premier élément est le nom de la mise en page et le deuxième élément doit avoir le format décrit dans Layouts.
Pour comprendre le format, consultez l'exemple suivant (il n'est pas destiné à faire quoi que ce soit d'utile) :
from tkinter import ttk import tkinter root = tkinter.Tk() style = ttk.Style() style.layout("TMenubutton", [ ("Menubutton.background", None), ("Menubutton.button", {"children": [("Menubutton.focus", {"children": [("Menubutton.padding", {"children": [("Menubutton.label", {"side": "left", "expand": 1})] })] })] }), ]) mbtn = ttk.Menubutton(text='Text') mbtn.pack() root.mainloop()
- element_create(elementname, etype, *args, **kw)¶
Create a new element in the current theme, of the given etype which is expected to be either "image", "from" or "vsapi". The latter is only available in Tk 8.6 on Windows.
Si image est utilisé, args doit contenir le nom de l'image par défaut suivi de paires statespec / value (il s'agit de l'imagespec), et kw peut avoir les options suivantes :
- border=remplissage
padding est une liste de quatre entiers maximum, spécifiant respectivement les bordures gauche, supérieure, droite et inférieure.
- height=hauteur
Spécifie une hauteur minimale pour l'élément. Si elle est inférieure à zéro, la hauteur de l'image de base est utilisée par défaut.
- padding= ajustement
Spécifie l'ajustement intérieur de l'élément. La valeur par défaut est la valeur de border si elle n'est pas spécifiée.
- sticky= spec
Spécifie comment l'image est placée dans la partie de l'espace attribué finale. spec contient zéro ou plusieurs caractères "n", "s", "w" ou "e".
- width=largeur
Spécifie une largeur minimale pour l'élément. Si inférieur à zéro, la largeur de l'image de base est utilisée par défaut.
Exemple :
img1 = tkinter.PhotoImage(master=root, file='button.png') img1 = tkinter.PhotoImage(master=root, file='button-pressed.png') img1 = tkinter.PhotoImage(master=root, file='button-active.png') style = ttk.Style(root) style.element_create('Button.button', 'image', img1, ('pressed', img2), ('active', img3), border=(2, 4), sticky='we')
Si from est utilisé comme valeur de etype,
element_create()
clone un élément existant. args doit contenir un nom de thème, à partir duquel l'élément est cloné, et éventuellement un élément à cloner. Si cet élément qu'il faut cloner n'est pas spécifié, un élément vide est utilisé. kw est ignoré.Exemple :
style = ttk.Style(root) style.element_create('plain.background', 'from', 'default')
If "vsapi" is used as the value of etype,
element_create()
will create a new element in the current theme whose visual appearance is drawn using the Microsoft Visual Styles API which is responsible for the themed styles on Windows XP and Vista. args is expected to contain the Visual Styles class and part as given in the Microsoft documentation followed by an optional sequence of tuples of ttk states and the corresponding Visual Styles API state value. kw may have the following options:- padding= ajustement
Specify the element's interior padding. padding is a list of up to four integers specifying the left, top, right and bottom padding quantities respectively. If fewer than four elements are specified, bottom defaults to top, right defaults to left, and top defaults to left. In other words, a list of three numbers specify the left, vertical, and right padding; a list of two numbers specify the horizontal and the vertical padding; a single number specifies the same padding all the way around the widget. This option may not be mixed with any other options.
- margins=padding
Specifies the elements exterior padding. padding is a list of up to four integers specifying the left, top, right and bottom padding quantities respectively. This option may not be mixed with any other options.
- width=largeur
Specifies the width for the element. If this option is set then the Visual Styles API will not be queried for the recommended size or the part. If this option is set then height should also be set. The width and height options cannot be mixed with the padding or margins options.
- height=hauteur
Specifies the height of the element. See the comments for width.
Exemple :
style = ttk.Style(root) style.element_create('pin', 'vsapi', 'EXPLORERBAR', 3, [ ('pressed', '!selected', 3), ('active', '!selected', 2), ('pressed', 'selected', 6), ('active', 'selected', 5), ('selected', 4), ('', 1)]) style.layout('Explorer.Pin', [('Explorer.Pin.pin', {'sticky': 'news'})]) pin = ttk.Checkbutton(style='Explorer.Pin') pin.pack(expand=True, fill='both')
Modifié dans la version 3.13: Added support of the "vsapi" element factory.
- element_names()¶
Renvoie la liste des éléments définis dans le thème courant.
- element_options(elementname)¶
Renvoie la liste des options de elementname.
- theme_create(themename, parent=None, settings=None)¶
Crée un nouveau thème.
C'est une erreur si themename existe déjà. Si parent est spécifié, le nouveau thème hérite des styles, des éléments et des mises en page du thème parent. Si settings est présent, il doit avoir la même syntaxe que celle utilisée pour
theme_settings()
.
- theme_settings(themename, settings)¶
Définit temporairement le thème actuel sur themename, applique les settings spécifiés, puis restaure le thème précédent.
Chaque clé dans settings est un style et chaque valeur peut contenir les clés
'configure'
,'map'
,'layout'
et'element create'
et elles doivent avoir le même format que celui spécifié par les méthodesStyle.configure()
,Style.map()
,Style.layout()
etStyle.element_create()
respectivement.À titre d'exemple, changeons un peu la Combobox pour le thème par défaut :
from tkinter import ttk import tkinter root = tkinter.Tk() style = ttk.Style() style.theme_settings("default", { "TCombobox": { "configure": {"padding": 5}, "map": { "background": [("active", "green2"), ("!disabled", "green4")], "fieldbackground": [("!disabled", "green3")], "foreground": [("focus", "OliveDrab1"), ("!disabled", "OliveDrab2")] } } }) combo = ttk.Combobox().pack() root.mainloop()
- theme_names()¶
Renvoie une liste de tous les thèmes connus.
- theme_use(themename=None)¶
Si themename n'est pas donné, renvoie le thème utilisé. Sinon, définit le thème actuel sur themename, actualise tous les widgets et lève un événement <<ThemeChanged>>.
Dispositions de mise en page¶
A layout can be just None
, if it takes no options, or a dict of
options specifying how to arrange the element. The layout mechanism
uses a simplified version of the pack geometry manager: given an
initial cavity, each element is allocated a parcel.
Les options/valeurs valides sont :
- side: whichside
Spécifie de quel côté de l'espace vide placer l'élément ; top (en haut), right (à droite), bottom (en bas) ou left (à gauche). S'il est omis, l'élément occupe toute l'espace.
- sticky: nswe
Spécifie où l'élément est placé à l'intérieur de sa partie d'espace alloué.
- unit: 0 or 1
Si défini sur 1, l'élément et tous ses descendants sont traités comme un seul élément aux fins de
Widget.identify()
et consœurs. Il est utilisé pour des choses comme la barre de défilement ou les agrandissements.- children: [sublayout... ]
Spécifie une liste d'éléments à placer à l'intérieur de l'élément. Chaque élément est un n-uplet (ou un autre type de séquence) où le premier élément est le nom de la mise en page et l'autre est un Layout.