tkinter - Optionen

Setzen und Abfragen von Optionen

Alle Widgets werden über Optionen konfiguriert. ttk- und tk-Widgets haben teilweise unterschiedliche Optionen.

Die folgenden Schreibweisen zum Setzen der Option text sind gleichwertig:

button = ttk.Button(parent, text='Klick mich bitte!')
button["text"] = 'Klick mich bitte!'
button.configure(text='Klick mich bitte!')

Man erhält mit button.cget('text') den aktuellen Wert der Option text des Widgets button.

Allgemeine Optionen

Labeloptionen

Dieses gilt für ttk.Button und ttk.Label gleichermaßen

Das folgende Programm zeigt die Auswirkung der Option padding:

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry('200x200')
        self._createWidgets()

    def _createWidgets(self):
        label1= ttk.Label(text='Label1', relief=tk.SUNKEN, padding=0)
        label1.pack(expand=tk.YES, fill=tk.BOTH)

        label2= ttk.Label(text='Label2', relief=tk.SUNKEN, padding=10)
        label2.pack(expand=tk.YES, fill=tk.BOTH)

        label3= ttk.Label(text='Label3', relief=tk.SUNKEN, padding=50)
        label3.pack(expand=tk.YES, fill=tk.BOTH)

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

Scrolloptionen

Optionen für das Zusammenspiel mit Scrollbars

Folgendes reduzierte Beispiel zeigt, wie es funktioniert:

listbox= tk.Listbox(…)
scrollX = ttk.Scrollbar(parent, orient=tk.HORIZONTAL, command=listbox.xview)
scrollY = ttk.Scrollbar(parent, orient=tk.VERTICAL, command=listbox.yview)

listbox['xscrollcommand'] = scrollX.set
listbox['yscrollcommand'] = scrollY.set

Rahmenoptionen

Beispiel:

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry("300x300")
        self._createWidgets()

    def _createWidgets(self):
        label1 = ttk.Label(self, relief=tk.FLAT, text="tk.FLAT");
        label1.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)
        label2 = ttk.Label(self, relief=tk.GROOVE, text="tk.GROOVE");
        label2.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)
        label3 = ttk.Label(self, relief=tk.RAISED, text="tk.RAISED");
        label3.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)
        label4 = ttk.Label(self, relief=tk.RIDGE, text="tk.RIDGE");
        label4.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)
        label5 = ttk.Label(self, relief=tk.SOLID, text="tk.SOLID");
        label5.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)
        label6 = ttk.Label(self, relief=tk.SUNKEN, text="tk.SUNKEN");
        label6.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)
        button = ttk.Button(self, text='Quit', command=self.destroy)
        button.pack(expand=tk.YES, fill=tk.BOTH, padx=2, pady=2)

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

Highlightoptionen (nur tk-Widgets)

tk Widgets haben einen Highlightrahmen. Diesen Rahmen kann man farblich markieren. Der Rahmen kann seine Farbe ändern, wenn das Widget den Input-Fokus erhält, also beispielsweise wenn die Option takefocus zusätzlich gesetzt wurde.

Um die Färbung im folgenden Beispiel zu sehen, kann man per TAB-Taste zwischen den Widgets wechseln:

import tkinter as tk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry('600x500')
        self._createWidgets()

    def _createWidgets(self):
        self.grid_columnconfigure(0, weight=1)
        self.grid_rowconfigure(0, weight=2)
        self.grid_rowconfigure(1, weight=2)
        self.grid_rowconfigure(2, weight=1)
        
        msg1 = tk.Message(self,
                          background='black',
                          fg='white',
                          highlightbackground='green',
                          highlightcolor='yellow',
                          highlightthickness=5,
                          takefocus=tk.YES)
        msg1['text']='Beispieltext\n#1'
        msg1.grid(column=0, row=0, sticky=tk.W+tk.E+tk.N+tk.S)
        msg2 = tk.Message(self,
                          background='black',
                          fg='white',
                          highlightbackground='green',
                          highlightcolor='yellow',
                          highlightthickness=5,
                          takefocus=tk.YES)
        msg2['text']='Beispieltext\n#2'
        msg2.grid(column=0, row=1, sticky=tk.W+tk.E+tk.N+tk.S)

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

Anker (anchor)

Anchor als Option hat verschiedene Bedeutungen in tkinter.

• In einem ttk.Label dient die Option anchor dazu, die Ausrichtung des Textes festzulegen, für zentriert beispielsweise tk.CENTER.
• In einem ttk.LabelFrame ist die Option labelanchor dazu da, das Label an sich zu positionieren.
• Im Place-Layout dient anchor dazu, einen Ort im Widget zu festzulegen. Dieser Ort im Widget, beispielsweise die untere rechte Ecke (tk.SE), wird an einen Punkt positioniert.

Tkinter kennt Konstanten (Himmelsrichtungen) für den Anker: tk.NW, tk.N, tk.NE, tk.W, tk.CENTER, tk.E, tk.SW, tk.S und tk.SE

Dimensionsangaben

Numerische Angaben zu Optionen können sowohl in Pixel wie auch in anderen Einheiten angegeben werden:

• x=10 -- meint 10 Pixel,
• x='10c' -- meint 10 Zentimeter,
• x='20i' -- meint 20 Zoll,
• x='30m' -- meint 20 Millimeter,
• x='10p' -- meint 10 Printer Points (1/72 Zoll).

Beispiel:

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry("300x300")
        self._createWidgets()
        
    def _createWidgets(self):
        self.label1 = ttk.Label(self, relief=tk.GROOVE, text="1 Zentimeter");
        self.label1.place(x=10, y='1c')
 
        self.label2 = ttk.Label(self, relief=tk.GROOVE, text="2 Inch");
        self.label2.place(x=10, y='2i')
 
        self.label3 = ttk.Label(self, relief=tk.GROOVE, text="30 mm");
        self.label3.place(x=10, y='30m')
 
        self.label4 = ttk.Label(self, relief=tk.GROOVE, text="10 Printers Points");
        self.label4.place(x=10, y='10p')
 
        self.quit = ttk.Button(self, text='Quit', command=self.destroy)
        self.quit.place(x=100,y=100)

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

Farbangaben

Farben können auf verschiedene Weisen notiert werden:

• als Farbname wie 'red', 'green', 'blue', …,
• als 12-Bit-Farbe: '#RgB',
• als 24-Bit-Farbe: '#RRggBB',
• als 36-Bit-Farbe: '#RRRgggBBB'.

Beispiel:

import tkinter as tk
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry("300x300")
        self._createWidgets()
        
    def _createWidgets(self):
        label1 = ttk.Label(self, relief=tk.GROOVE, text="Ich bin rot", background='red');
        label1.pack(fill=tk.BOTH, expand=tk.YES)
        label2 = ttk.Label(self, relief=tk.GROOVE, text="Ich bin blau", background='#00F');
        label2.pack(fill=tk.BOTH, expand=tk.YES)
        label3 = ttk.Label(self, relief=tk.GROOVE, text="Ich bin grün", background='#00aa00');
        label3.pack(fill=tk.BOTH, expand=tk.YES)
        label4 = ttk.Label(self, relief=tk.GROOVE, text="Ganz Weiß", background='#fffffffff');
        label4.pack(fill=tk.BOTH, expand=tk.YES)
        
        button = ttk.Button(self, text='Quit', command=self.destroy)
        button.pack()

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

Font als Tupel

Ein Font kann beschrieben werden als ein Tupel aus Familie, Größe und Optionen. Beispiele sind ('Helvetica', 10, 'bold') und ('Courier', 20, font.BOLD, font.ITALIC).

Beispiel:

import tkinter as tk
import tkinter.font as font
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry("300x300")
        self._createWidgets()
 
    def _createWidgets(self):
        label1 = ttk.Label(self, anchor=tk.CENTER, text="Helvetica 10",
                           font=('Helvetica', 10));
        label1.pack(fill=tk.BOTH, expand=tk.YES)
        label2 = ttk.Label(self, anchor=tk.CENTER, text="Helvetica 20",
                           font=('Helvetica', 20));
        label2.pack(fill=tk.BOTH, expand=tk.YES)
        label3 = ttk.Label(self, anchor=tk.CENTER, text="Helvetica 10 Bold",
                           font=('Helvetica', 10, font.BOLD));
        label3.pack(fill=tk.BOTH, expand=tk.YES)
        label4 = ttk.Label(self, anchor=tk.CENTER, text="Helvetica 10 Italic",
                           font=('Helvetica', 10, font.ITALIC));
        label4.pack(fill=tk.BOTH, expand=tk.YES)
        label5 = ttk.Label(self, anchor=tk.CENTER, text="Helvetica 10 Bold+Italic",
                           font=('Helvetica', 10, font.BOLD, font.ITALIC));
        label5.pack(fill=tk.BOTH, expand=tk.YES)
        button = ttk.Button(self, text='Quit', command=self.destroy)
        button.pack()

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

Fontobjekt

Ein Fontobjekt lässt sich mit font.Font(root=None, font=None, name=None, exists=False, **options) erzeugen. Die Parameter bedeuten:

• font: ist dabei ein Fonttupel in der Form: (family, size, options) wie oben,
• name: ein eindeutiger Name. Einige Fonts sind vorbenannt, mit font.names() erhält man ein Tupel dieser Namen.
• options: Optionen aus der folgenden Tabelle.

Beispiel:

import tkinter as tk
import tkinter.font as font
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry("300x200")
        self._createWidgets()

    def _createWidgets(self):
        f = font.Font(family='Courier', size=50)
        label1 = ttk.Label(self, anchor=tk.CENTER, text="Courier 20", font=f);
        label1.pack(fill=tk.BOTH, expand=tk.YES)
        
        button = ttk.Button(self, text='Quit', command=self.destroy)
        button.pack()

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

Für einen gegebenen Font f gibt es die folgenden Methoden:

Weitere Fontmethoden

Das Fontmodul kennt die Funktionen:

Kontrollvariablen

Für die Kommunikation mit manchen Widgets werden Kontrollvariablen eingesetzt. Mit denen kann beispielsweise der Text eines Labels an anderer Stelle geändert werden.

Es gibt folgende Kontrollvariablen, die mit dem optionalen Parameter value vorbelegt werden können:

• tk.BooleanVar(value=True)
• tk.DoubleVar(value=7.0)
• tk.IntVar(value=3)
• tk.StringVar(value='Hallo, Welt!')

Zu diesen Kontrollvariablen gehören die Methoden var.get() sowie var.set(value)

Gebrauch:

• Button, Entry, Label, Menubutton: Option textvariable,
• Radiobutton: Option variable, mehrere Radiobuttons teilen sich eine Variable und bilden dadurch eine Buttongroup,
• Scale: Option variable, die den Wert enthält,
• Checkbutton: Option variable
• LabeledScale: Option variable

Manche Widgets, wie Checkbutton, haben noch die Optionen onvalue und offvalue, um diese angegebenen Werte in der Variablen zu speichern: Einen Wert, der der Kontrollvariable als on- oder off-Wert übergeben wird.

import tkinter as tk
import tkinter.font as font
from tkinter import ttk

class A(tk.Tk):
    def __init__(self):
        super().__init__()
        self.geometry("300x200")
        self._createWidgets()

    def _createWidgets(self):
        self._textVar = tk.StringVar(value='Drück mich bitte.')
        button1 = ttk.Button(self, textvariable=self._textVar, command=self._onPress)
        button1.pack(fill=tk.X, expand=tk.YES)
        
        button = ttk.Button(self, text='Quit', command=self.destroy)
        button.pack()

    def _onPress(self):
        self._textVar.set('Danke!')

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

Zustand - state

Ein Widget kann in einem von vielen Zuständen sein. Für ttk-Widget sind diese Zustände:

• active: Maus schwebt über einem Widget, wie einem Button, zumeist ändert das Widget daraufhin seine Farbe,
• disabled: Widget ist deaktiviert und keine Interaktion ist mit diesem Widget möglich,
• focus: Widget hat Keyboard-Fokus, drückt man Tasten landen sie im Widget,
• pressed: das Widget wird gerade gedrückt, zumeist ändert sich dann seine Farbe,
• selected: das Widget ist "eingeschaltet" oder "ausgewählt". Radiobuttons oder Checkbuttons kennen diesen Zustand,
• background: das Widgets ist in einem "Hintergrundfenster". Dieser Zustand wird nur von einigen Betriebssystemen unterstützt,
• readonly: das Widget ist grundsätzlich nicht beschreibbar, etwa eine Eingabezeile, aus der man nur Text mit ins Clipboard kopieren kann
• alternate: etwa der dritte Zustand bei Checkbuttons, bevor er selektiert/deselektiert wurde,
• invalid: beispielsweise ungültiger Wert in einem Entry nach Validierung,
• hover: ähnlich wie active, zumeist bei Themes benutzt

Die Zustände werden mit Methoden wie instate(…) oder state(…) abgefragt / verändert.

Tk-Widgets kennen nur die States disabled, normal und readonly. Diese gibt man üblicherweise als Option state an und ändert sie mit w.configure(…)