tkinter - ttk.Treeview

ttk.Treeview erzeugen

tv = ttk.Treeview(parent, Optionen)

Treeview kennt die Optionen:

ttk.Treeview kennt die Standardoptionen: class_, cursor, padding, style, takefocus, xscrollcommand und yscrollcommand

Das folgende Programm erzeugt eine Treeview mit drei Spalten: '#0' alias 'Hörspiel', 'Folge' und 'Nummer'. Die erste und mittlere Spalte dürfen sich ausdehnen, die Texte in den Spaltenköpfen werden ausgerichtet. Ferner werden Daten eingefügt.:

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry('400x400')
        self._createWidgets()

    def _createWidgets(self):
        tv = ttk.Treeview(self, columns=('Folge', 'Nummer'))
        # Spalten
        tv.column('#0', stretch=tk.YES, width=50)
        tv.column('Folge', stretch=tk.YES, width=100)
        tv.column('Nummer', stretch=tk.NO, width=50)
        # Spaltenköpfe (Heading)
        tv.heading('#0', anchor=tk.W, text='Hörspiel')
        tv.heading('Folge', anchor=tk.CENTER, text='Folge')
        tv.heading('Nummer', anchor=tk.E, text='Nummer der Folge')
        # ins layout einfügen
        tv.pack(fill=tk.X, expand=tk.YES)
        # Daten hinzu
        iid = tv.insert('', tk.END, text='???')
        tv.insert(iid, tk.END, text='Drei Fragezeichen',
                  values=('Der Super-Papagei', '1'))
        tv.insert(iid, tk.END, text='Drei Fragezeichen',
                  values=('Der Phantomsee', '2'))
        tv.insert('', tk.END, text='Hui Buh',
                  values=('Das Schlossgespenst', 1))

if __name__ == '__main__':
    window = A()
    window.mainloop()

Spaltenbezeichner

Spalten einer Treeview können auf verschiedene Weisen benannt werden:

• symbolische Namen wie "meine Spalte 1"
• numerisch, wie 1, 2, …
• '#n', wobei n die N-te angezeigte Spalte ist (vgl. Option displaycolumns
• Es gibt immer eine Spalte mit der Bezeichnung '#0'. Diese kann man nicht explizit erzeugen und nicht löschen. Diese enthält ein Label und gegebenfalls eine Markierung zum ausklappen von Unterabschnitten.

Itemoptionen

Zeilen innerhalb einer Treeview heißen Items, diese haben Optionen:

Tagoptionen

Tags können mit folgenden Optionen konfiguriert werden:

Treeview-Methoden

Spaltenoptionen, wie von tv.column(…), … verwendet:

Spaltenkopfoptionen, wie von tv.heading(…) verwendet:

Methoden von ttk.Treeview():

Im folgenden Beispiel wird ein Mausklick-Ereignis an einen Tag gebunden, das angeklickte und aktive Element wird in einem Label angezeigt

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry('400x400')
        self._createWidgets()

    def _createWidgets(self):
        self.tv = ttk.Treeview(self, columns=('Folge', 'Nummer'))
        self.tv.pack(fill=tk.X, expand=tk.YES)
        # Daten hinzu
        self.tv.insert('', tk.END, text='Drei Fragezeichen',
                  values=('Der Super-Papagei', '1'), tags=('hoerspiel',))
        self.tv.insert('', tk.END, text='Hui Buh',
                  values=('Das Schlossgespenst', 1), tags=('hoerspiel',))

        self.tv.tag_bind('hoerspiel', '<1>', callback=self._onClick)

        self.tVar = tk.StringVar()
        label = ttk.Label(self, textvariable=self.tVar)
        label.pack(fill=tk.X, expand=tk.YES)


    def _onClick(self, event):
        text = ''
        for selectedElem in self.tv.selection():
            item = self.tv.item(selectedElem)
            text += item['text'] + ' '
        self.tVar.set(text)


if __name__ == '__main__':
    window = A()
    window.mainloop()

Im folgenden Beispiel werden Tags farbig konfiguriert.

Hinweis: TK-Versionen vor 8.6.9 können Tags auf diese Weise nicht verändern.

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry('400x400')
        self._createWidgets()

    def _createWidgets(self):
        self.tv = ttk.Treeview(self, columns=('Folge', 'Nummer'))
        self.tv.pack(fill=tk.X, expand=tk.YES)
        # Daten hinzu
        self.tv.insert('', tk.END, text='Drei Fragezeichen',
                  values=('Der Super-Papagei', '1'), tags=('serie1',))
        self.tv.insert('', tk.END, text='Hui Buh',
                  values=('Das Schlossgespenst', 1), tags=('serie2',))

        self.tv.tag_configure('serie1', background='green')
        self.tv.tag_configure('serie2', background='yellow')

if __name__ == '__main__':
    window = A()
    window.mainloop()

Virtuelle Ereignisse

• <<TreeviewSelect>> -- Auswahlt wird geändert
• <<TreeviewOpen>> -- ein Tree wird geöffnet
• <<TreeviewClose>> -- ein Tree wird geschlossen

Siehe Auch