`tkinter.ttk` --- Tk themed widgets¶

Code source : Lib/tkinter/ttk.py

The tkinter.ttk module provides access to the Tk themed widget set, introduced in Tk 8.5. It provides additional benefits including anti-aliased font rendering under X11 and window transparency (requiring a composition window manager on X11).

The basic idea for tkinter.ttk is to separate, to the extent possible, the code implementing a widget's behavior from the code implementing its appearance.

Ajouté dans la version 3.1.

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 *

That code causes several tkinter.ttk widgets (Button, Checkbutton, Entry, Frame, Label, LabelFrame, Menubutton, PanedWindow, Radiobutton, Scale and Scrollbar) to automatically replace the Tk widgets.

This has the direct benefit of using the new widgets which gives a better look and feel across platforms; however, the replacement widgets are not completely compatible. The main difference is that widget options such as "fg", "bg" and others related to widget styling are no longer present in Ttk widgets. Instead, use the ttk.Style class for improved styling effects.

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.

Ttk widgets¶

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 defines standard options and methods supported by Tk themed widgets and is not supposed to be directly instantiated.

Standard options¶

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	Specifies the mouse cursor to be used for the widget. If set to the empty string (the default), the cursor is inherited from the parent widget.
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é.

Scrollable widget options¶

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.

When the view in the widget's window changes, the widget calls the xscrollcommand callback.

Usually this option consists of the method Scrollbar.set of some scrollbar. This will cause the scrollbar to be updated whenever the view in the window changes.

yscrollcommand

Utilisé pour communiquer avec les barres de défilement vertical. Pour plus d'informations, voir ci-dessus.

Label options¶

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 `Style.map()`, spécifiant différentes images à utiliser lorsque le widget est dans un état particulier ou une combinaison d'états. Toutes les images de la liste doivent avoir la même taille.
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 : text : afficher uniquement le texte image : afficher uniquement l'image top, bottom, left, right : afficher l'image au-dessus, en dessous, à gauche ou à droite du texte, respectivement. none : la valeur par défaut. Afficher l'image si présente, sinon le texte.
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.

Compatibility options¶

Option	Description
state	Peut être défini sur `"normal"` ou `"disabled"` pour contrôler le bit d'état d'activation. Il s'agit d'une option en écriture seule : sa définition modifie l'état du widget, mais la méthode `Widget.state()` n'affecte pas cette option.

Widget states¶

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	`"On"`, `"true"` ou `"current"` pour des choses comme les boutons de contrôle et les boutons radio
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¶

Besides the methods described below, the ttk.Widget supports the methods tkinter.Widget.cget and 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 et False 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¶

The ttk.Combobox widget combines a text field with a pop-down list of values. This widget is a subclass of Entry.

Besides the methods inherited from Widget: cget(), configure(), identify(), instate() and state(), and the following inherited from Entry: bbox(), delete(), icursor(), index(), insert(), selection*, xview*, it has some other methods, described at ttk.Combobox.

Options¶

Ce widget accepte les options spécifiques suivantes :

Option	Description
exportationsselection	Boolean value. If set, the widget selection is linked to the X selection (which can be returned by invoking Misc.selection_get, for example).
justify	Spécifie comment le texte est aligné dans le widget. Les valeurs possibles sont `"left"`, `"center"` ou `"right"`.
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	One of "normal", "readonly", or "disabled". In the "readonly" state, the value may not be edited directly, and the user can only select one of the values from the dropdown list. In the "normal" state, the text field is directly editable. In the "disabled" state, no interaction is possible.
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 `tkinter.StringVar`.
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.

Note

Tk 9.1 added the locale option, which selects the locale used to determine word and character boundaries within the text ("C" by default).

É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¶

The ttk.Spinbox widget is a ttk.Entry enhanced with increment and decrement arrows. It can be used for numbers or lists of string values. This widget is a subclass of Entry. Besides the methods inherited from Widget: cget(), configure(), identify(), instate() and state(), and the following inherited from Entry: bbox(), delete(), icursor(), index(), insert(), xview*, it has some other methods, described at 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 `from_` lorsqu'il est utilisé comme argument, car `from` est un mot-clé Python.
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 `True`, les boutons d'incrémentation et de décrémentation passent de la valeur `to` à la valeur `from` ou de la valeur `from` à la valeur `to`, respectivement.
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 `"%W.Pf"`, où W est la largeur de la valeur, P est la précision et `'%'` et `'f'` sont littéraux.
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¶

class tkinter.ttk.Spinbox¶

Ajouté dans la version 3.8.

get()¶: Renvoie la valeur actuelle du spinbox.

set(value)¶: Définit la valeur du spinbox sur value.

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.

Tab options¶

Il existe également des options spécifiques pour les onglets :

Option	Description
state	Soit `"normal"`, `"disabled"` ou `"hidden"`. Si disabled, l'onglet n'est pas sélectionnable. S'il est hidden, l'onglet n'est pas affiché.
sticky	Specifies how the child window is positioned within the pane area. Value is a string containing zero or more of the characters "n", "s", "e" or "w". Each letter refers to a side (north, south, east or west) that the child window will stick to, as per the `grid` geometry manager.
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 `Widget`.
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 `Notebook.enable_traversal()` est appelé.

Tab identifiers¶

The tab_id present in several methods of ttk.Notebook may take any of the following forms:

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 pour Notebook.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()¶: Returns a tuple of windows managed by the 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.

Multiple notebooks in a single toplevel may be enabled for traversal, including nested notebooks. However, notebook traversal only works properly if all panes are direct children of the notebook.

Barre de progression¶

The ttk.Progressbar widget shows the status of a long-running operation. It can operate in two modes: 1) the determinate mode which shows the amount completed relative to the total amount of work to be done and 2) the indeterminate mode which provides an animated display to let the user know that work is progressing.

Options¶

Ce widget accepte les options spécifiques suivantes :

Option	Description
orient	`"horizontal"` ou `"vertical"`. Spécifie l'orientation de la barre de progression.
length	Spécifie la longueur de l'axe long de la barre de progression (largeur si horizontale, hauteur si verticale).
mode	`"determinate"` ou `"indeterminate"`.
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¶

The ttk.Separator widget displays a horizontal or vertical separator bar.

It has no other methods besides the ones inherited from ttk.Widget.

Options¶

Ce widget accepte l'option spécifique suivante :

Option	Description
orient	`"horizontal"` ou `"vertical"`. Spécifie l'orientation du séparateur.

Poignée de redimensionnement¶

The ttk.Sizegrip widget (also known as a grow box) allows the user to resize the containing toplevel window by pressing and dragging the grip.

This widget has neither specific options nor specific methods, besides the ones inherited from 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¶

If the containing toplevel's position was specified relative to the right or bottom of the screen (for example, ....), the Sizegrip widget will not resize the window.
Ce widget ne prend en charge que le redimensionnement "southeast".

Arborescence¶

The ttk.Treeview widget displays a hierarchical collection of items. Each item has a textual label, an optional image, and an optional list of data values. The data values are displayed in successive columns after the tree label.

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 `"#all"`.
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 `"extended"`, `"browse"` ou `"none"`. S'il est défini sur extended (valeur par défaut), plusieurs éléments peuvent être sélectionnés. Si c'est browse un seul élément ne peut être sélectionné à la fois. Si c'est none, la sélection ne peut pas être modifiée. 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. tree : affiche les étiquettes de l'arbre dans la colonne 0. headings : affiche la ligne d'en-tête. The default is "tree headings", that is, show all elements. Remarque : la colonne 0 fait toujours référence à la colonne de l'arborescence, même si `show="tree"` n'est pas spécifié.

Note

Tk 9.0 added several Treeview features. The selectmode option gained the values "single" and "multiple"; the new widget options selecttype ("item" or "cell" selection), striped (zebra-striped rows), and titlecolumns / titleitems (columns or rows frozen against scrolling) were introduced; and items gained a hidden option. Tk 9.1 added the rowheight and headingheight options.

Item options¶

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 `True` ou `False` indiquant si les enfants de l'élément doivent être affichés ou masqués.
tags	Liste de balises associées à cet élément.

Tag options¶

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.

Column identifiers¶

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 n^ième colonne de données.
Une chaîne de la forme #n, où n est un entier, spécifiant la n^iè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 `open=True`.
<<TreeviewClose>>	Généré juste après avoir défini l'élément de focus sur `open=False`.

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).

If column is specified, returns the bounding box of that cell. If the item is not visible (that is, if it is a descendant of a closed item or is scrolled offscreen), returns an empty string.

get_children(item=None)¶

Returns a tuple of children belonging to item.

Si item n'est pas spécifié, renvoie les enfants racine.

set_children(item, *newchildren)¶

Replaces item's children with 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)¶: Returns True if the specified item is present in the tree, False otherwise.

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)¶

Returns the display column identifier of the cell at 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é.

reattach() is an alias of move().

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.

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)¶

If item is specified, returns True if the specified item has the given tagname and False otherwise. Otherwise, returns a tuple of all items that have the specified tag.

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.

Ttk styling¶

Each widget in ttk is assigned a style, which specifies the set of elements making up the widget and how they are arranged, along with dynamic and default settings for element options. By default the style name is the same as the widget's class name, but it may be overridden by the widget's style option. If you don't know the class name of a widget, use the method 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é.

When called to query the map (without specifying values to set), it returns a dictionary mapping each option to its list of statespecs.

Modifié dans la version 3.10: The value returned when querying the map was corrected.

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()¶: Returns a tuple of elements defined in the current theme.

element_options(elementname)¶: Returns a tuple of elementname's options.

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éthodes Style.configure(), Style.map(), Style.layout() et Style.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()¶: Returns a tuple of all known themes.

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.

Additional widgets¶

The following themed widgets complete the tkinter.ttk widget set. Each is the themed counterpart of the like-named classic tkinter widget and inherits the common methods of Widget.

class tkinter.ttk.Button(master=None, **kw)¶

Ttk Button widget, displays a textual label and/or image, and evaluates a command when pressed. It is the themed counterpart of tkinter.Button and inherits the common widget methods from Widget.

invoke()¶: Invoke the command associated with the button and return its result.

class tkinter.ttk.Checkbutton(master=None, **kw)¶

Ttk Checkbutton widget, used to control a boolean variable that is toggled on and off. It is the themed counterpart of tkinter.Checkbutton and inherits the common widget methods from Widget.

invoke()¶: Toggle the button between its selected and deselected states, invoke the command associated with the button, and return its result.

class tkinter.ttk.Entry(master=None, widget=None, **kw)¶

Ttk Entry widget, displays a one-line text string and allows the user to edit it. It is the themed counterpart of tkinter.Entry and inherits the common widget methods from Widget as well as the editing methods from tkinter.Entry.

bbox(index)¶: Return a tuple (x, y, width, height) giving the bounding box of the character at the given index.

identify(x, y)¶: Return the name of the element under the point given by x and y, or the empty string if no element is present at that location.

validate()¶: Force validation of the entry and return True if validation succeeded, and False otherwise.

class tkinter.ttk.Frame(master=None, **kw)¶: Ttk Frame widget, a container used to group and lay out other widgets. It is the themed counterpart of tkinter.Frame and inherits the common widget methods from Widget.

class tkinter.ttk.Label(master=None, **kw)¶: Ttk Label widget, displays a textual label and/or image. It is the themed counterpart of tkinter.Label and inherits the common widget methods from Widget.

class tkinter.ttk.Labelframe(master=None, **kw)¶: Ttk Labelframe widget, a container that draws a border and a title label around its contents. It is the themed counterpart of tkinter.LabelFrame and inherits the common widget methods from Widget.

class tkinter.ttk.Menubutton(master=None, **kw)¶: Ttk Menubutton widget, displays a textual label and/or image, and pops up a menu when pressed. It is the themed counterpart of tkinter.Menubutton and inherits the common widget methods from Widget.

class tkinter.ttk.OptionMenu(master, variable, default=None, *values, **kwargs)¶

Ttk OptionMenu widget, a Menubutton that pops up a menu of mutually exclusive choices. variable is the variable that tracks the currently selected value, default is the value to set initially, and values are the entries to display in the menu. A command keyword argument may be given to specify a callable that is invoked with the selected value whenever the selection changes; the style keyword argument sets the style used by the underlying menubutton; and the name keyword argument sets the Tk widget name.

set_menu(default=None, *values)¶: Replace the entries of the menu with values. If default is given, also set it as the current value of the variable.

destroy()¶: Destroy this widget and its associated menu.

Modifié dans la version 3.14: Added support for the name keyword argument.

class tkinter.ttk.Panedwindow(master=None, **kw)¶

Ttk Panedwindow widget, displays a number of subwindows stacked either vertically or horizontally. The user may adjust the relative sizes of the subwindows by dragging the sash between panes. It is the themed counterpart of tkinter.PanedWindow and inherits the common widget methods from Widget, as well as the add() and panes() methods from tkinter.PanedWindow.

insert(pos, child, **kw)¶: Insert a pane containing child at the position pos. pos is either the string 'end', an integer index, or the name of a managed subwindow. If child is already managed by the paned window, move it to the specified position. Any keyword arguments set pane options.

forget(child)¶: Remove child, which may be either an integer index or the name of a managed subwindow, from the panes.

pane(pane, option=None, **kw)¶: Query or modify the options of the specified pane, where pane is either an integer index or the name of a managed subwindow. If no arguments are given, return a dictionary of the pane option values. If option is specified, return the value of that option. Otherwise, set the options given as keyword arguments to their corresponding values.

sashpos(index, newpos=None)¶: If newpos is specified, set the position of sash number index and return its new position. This may adjust the positions of adjacent sashes to ensure that positions are monotonically increasing; positions are also constrained to be between 0 and the total size of the widget. If newpos is omitted, return the current position of the sash.

class tkinter.ttk.Radiobutton(master=None, **kw)¶

Ttk Radiobutton widget, used as part of a group to control a single shared variable by selecting one of several mutually exclusive values. It is the themed counterpart of tkinter.Radiobutton and inherits the common widget methods from Widget.

invoke()¶: Set the option variable to the button's value, select the button, invoke the command associated with the button, and return its result.

class tkinter.ttk.Scale(master=None, **kw)¶

Ttk Scale widget, displays a slider that lets the user select a numeric value from a range by moving the slider along a trough. It is the themed counterpart of tkinter.Scale and inherits the common widget methods from Widget.

configure(cnf=None, **kw)¶: Modify or query the widget options, like Widget.configure. In addition, this method clips the from and to values so that the current value stays within the range defined by them.

Modifié dans la version 3.9: Now returns the configuration value, like Widget.configure.

get(x=None, y=None)¶: Return the current value of the scale. If x and y are given, return the value corresponding to the pixel coordinate x, y instead.

class tkinter.ttk.Scrollbar(master=None, **kw)¶: Ttk Scrollbar widget, controls the viewport of an associated scrollable widget such as a Treeview, Entry or tkinter.Text. It is the themed counterpart of tkinter.Scrollbar and inherits the common widget methods from Widget, as well as the set() and get() methods from tkinter.Scrollbar.

class tkinter.ttk.Separator(master=None, **kw)¶: Ttk Separator widget, displays a horizontal or vertical separator line. It has no direct counterpart in tkinter and inherits the common widget methods from Widget.

class tkinter.ttk.Sizegrip(master=None, **kw)¶: Ttk Sizegrip widget, displays a grip that allows the user to resize the containing toplevel window by pressing and dragging the grip, typically placed in the bottom-right corner. It has no direct counterpart in tkinter and inherits the common widget methods from Widget.

class tkinter.ttk.LabeledScale(master=None, variable=None, from_=0, to=10, **kw)¶

A Frame containing a Scale and a Label that shows the scale's current value. variable is the IntVar tracked by the scale (one is created if it is not given), and from_ and to define the range of the scale.

destroy()¶: Destroy this widget and remove the trace callback registered on the associated variable.

class tkinter.ttk.LabelFrame(master=None, **kw)¶: Alias of Labelframe, kept for naming compatibility with tkinter.LabelFrame.

class tkinter.ttk.PanedWindow(master=None, **kw)¶: Alias of Panedwindow, kept for naming compatibility with tkinter.PanedWindow.

tkinter.ttk --- Tk themed widgets¶

Utilisation de Ttk¶

Ttk widgets¶

Widget¶

Standard options¶

Scrollable widget options¶

Label options¶

Compatibility options¶

Widget states¶

ttk.Widget¶

Combobox¶

Options¶

Événements virtuels¶

ttk.Combobox¶

Spinbox¶

Options¶

Événements virtuels¶

ttk.Spinbox¶

Carnet de notes (notebook)¶

Options¶

Tab options¶

Tab identifiers¶

Événements virtuels¶

ttk.Notebook¶

Barre de progression¶

Options¶

ttk.Progressbar¶

Séparateur¶

Options¶

Poignée de redimensionnement¶

Notes spécifiques à une plateforme¶

Bogues¶

Arborescence¶

Options¶

Item options¶

Tag options¶

Column identifiers¶

Événements virtuels¶

ttk.Treeview¶

Ttk styling¶

Dispositions de mise en page¶

Additional widgets¶

`tkinter.ttk` --- Tk themed widgets¶