Tkinter Dialoge

tkinter.simpledialog — Standard Tkinter Eingabedialoge

Quellcode: Lib/tkinter/simpledialog.py

Das Modul tkinter.simpledialog enthält praktische Klassen und Funktionen zur Erstellung einfacher, modaler Dialoge, um einen Wert vom Benutzer zu erhalten.

tkinter.simpledialog.askfloat(title, prompt, **kw)
tkinter.simpledialog.askinteger(title, prompt, **kw)
tkinter.simpledialog.askstring(title, prompt, **kw)

Die oben genannten drei Funktionen bieten Dialoge, die den Benutzer auffordern, einen Wert des gewünschten Typs einzugeben.

class tkinter.simpledialog.Dialog(parent, title=None)

Die Basisklasse für benutzerdefinierte Dialoge.

body(master)

Überschreiben Sie diese Methode, um die Benutzeroberfläche des Dialogs zu erstellen und das Widget zurückzugeben, das den anfänglichen Fokus erhalten soll.

buttonbox()

Das Standardverhalten fügt OK- und Abbrechen-Schaltflächen hinzu. Überschreiben Sie diese Methode für benutzerdefinierte Schaltflächenlayouts.

tkinter.filedialog — Dateiauswahldialoge

Quellcode: Lib/tkinter/filedialog.py

Das Modul tkinter.filedialog bietet Klassen und Factory-Funktionen zur Erstellung von Datei-/Verzeichnisauswahlfenstern.

Native Lade-/Speicherdialoge

Die folgenden Klassen und Funktionen bieten Dateidialogfenster, die ein natives Erscheinungsbild mit Konfigurationsoptionen zur Anpassung des Verhaltens kombinieren. Die folgenden Schlüsselwortargumente gelten für die unten aufgeführten Klassen und Funktionen

parent – das Fenster, auf dem der Dialog angezeigt werden soll
title – der Titel des Fensters
initialdir – das Verzeichnis, in dem der Dialog startet
initialfile – die beim Öffnen des Dialogs ausgewählte Datei
filetypes – eine Sequenz von (Label, Muster)-Tupeln; '*' als Platzhalter ist erlaubt
defaultextension – Standarderweiterung, die an den Dateinamen angehängt wird (Speicherdialoge)
multiple – wenn wahr, ist die Auswahl mehrerer Elemente erlaubt

Statische Factory-Funktionen

Die unten aufgeführten Funktionen erstellen beim Aufruf einen modalen Dialog mit nativem Erscheinungsbild, warten auf die Auswahl des Benutzers und geben dann die ausgewählten Werte oder None an den Aufrufer zurück.

tkinter.filedialog.askopenfile(mode='r', **options)
tkinter.filedialog.askopenfiles(mode='r', **options)

Die obigen beiden Funktionen erstellen einen Open-Dialog und geben das/die geöffnete(n) Dateiobjekt(e) im schreibgeschützten Modus zurück.

tkinter.filedialog.asksaveasfile(mode='w', **options)

Erstellt einen SaveAs-Dialog und gibt ein im Nur-Schreib-Modus geöffnetes Dateiobjekt zurück.

tkinter.filedialog.askopenfilename(**options)
tkinter.filedialog.askopenfilenames(**options)

Die obigen beiden Funktionen erstellen einen Open-Dialog und geben den/die ausgewählten Dateinamen zurück, der/die vorhandenen Datei(en) entspricht/entsprechen.

tkinter.filedialog.asksaveasfilename(**options)

Erstellt einen SaveAs-Dialog und gibt den ausgewählten Dateinamen zurück.

tkinter.filedialog.askdirectory(**options)
Fordert den Benutzer zur Auswahl eines Verzeichnisses auf.
Zusätzliche Schlüsselwortoption
mustexist – bestimmt, ob die Auswahl ein vorhandenes Verzeichnis sein muss.
class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)

Die beiden obigen Klassen bieten native Dialogfenster zum Speichern und Laden von Dateien.

Praktische Klassen

Die unten aufgeführten Klassen werden zur Erstellung von Datei-/Verzeichnisfenstern von Grund auf verwendet. Diese emulieren nicht das native Erscheinungsbild der Plattform.

class tkinter.filedialog.Directory(master=None, **options)

Erstellt einen Dialog, der den Benutzer zur Auswahl eines Verzeichnisses auffordert.

Hinweis

Die Klasse FileDialog sollte für benutzerdefinierte Ereignisbehandlung und Verhalten unterklassifiziert werden.

class tkinter.filedialog.FileDialog(master, title=None)

Erstellt einen grundlegenden Dateiauswahldialog.

cancel_command(event=None)

Löst die Beendigung des Dialogfensters aus.

dirs_double_event(event)

Ereignisbehandlungsroutine für Doppelklick-Ereignisse auf ein Verzeichnis.

dirs_select_event(event)

Ereignisbehandlungsroutine für Klick-Ereignisse auf ein Verzeichnis.

files_double_event(event)

Ereignisbehandlungsroutine für Doppelklick-Ereignisse auf eine Datei.

files_select_event(event)

Ereignisbehandlungsroutine für Einzelklick-Ereignisse auf eine Datei.

filter_command(event=None)

Filtert die Dateien nach Verzeichnis.

get_filter()

Ruft den aktuell verwendeten Dateifilter ab.

get_selection()

Ruft das aktuell ausgewählte Element ab.

go(dir_or_file=os.curdir, pattern='*', default='', key=None)

Rendert den Dialog und startet die Ereignisschleife.

ok_event(event)

Beendet den Dialog und gibt die aktuelle Auswahl zurück.

quit(how=None)

Beendet den Dialog und gibt den Dateinamen zurück, falls vorhanden.

set_filter(dir, pat)

Legt den Dateifilter fest.

set_selection(file)

Aktualisiert die aktuelle Dateiauswahl auf file.

class tkinter.filedialog.LoadFileDialog(master, title=None)

Eine Unterklasse von FileDialog, die ein Dialogfenster zur Auswahl einer vorhandenen Datei erstellt.

ok_command()

Testet, ob eine Datei angegeben ist und ob die Auswahl eine bereits vorhandene Datei darstellt.

class tkinter.filedialog.SaveFileDialog(master, title=None)

Eine Unterklasse von FileDialog, die ein Dialogfenster zur Auswahl einer Zieldatei erstellt.

ok_command()

Testet, ob die Auswahl auf eine gültige Datei verweist, die kein Verzeichnis ist. Eine Bestätigung ist erforderlich, wenn eine bereits vorhandene Datei ausgewählt wird.

tkinter.commondialog — Dialogfenstervorlagen

Quellcode: Lib/tkinter/commondialog.py

Das Modul tkinter.commondialog stellt die Klasse Dialog bereit, die die Basisklasse für Dialoge ist, die in anderen unterstützenden Modulen definiert sind.

class tkinter.commondialog.Dialog(master=None, **options)
show(**options)

Rendert das Dialogfenster.

Siehe auch

Module tkinter.messagebox, Lesen und Schreiben von Dateien