tkinter.messagebox — Tkinter-Nachrichtenaufforderungen

Quellcode: Lib/tkinter/messagebox.py

---

Das Modul tkinter.messagebox stellt eine Vorlagenbasisklasse sowie eine Vielzahl von Komfortmethoden für gängige Konfigurationen bereit. Die Nachrichtenfenster sind modal und geben eine Teilmenge von (True, False, None, OK, CANCEL, YES, NO) zurück, basierend auf der Auswahl des Benutzers. Gängige Nachrichtenfensterstile und -layouts umfassen unter anderem

class tkinter.messagebox.Message(master=None, **options)

Erstellt ein Nachrichtenfenster mit einer vom Anwender spezifizierten Nachricht, einem Icon und einer Reihe von Schaltflächen. Jede der Schaltflächen im Nachrichtenfenster wird durch einen eindeutigen symbolischen Namen identifiziert (siehe die Optionen vom Typ type).

Die folgenden Optionen werden unterstützt

command

Gibt die Funktion an, die aufgerufen wird, wenn der Benutzer den Dialog schließt. Der Name der Schaltfläche, die der Benutzer zum Schließen des Dialogs geklickt hat, wird als Argument übergeben. Dies ist nur unter macOS verfügbar.

default

Gibt den symbolischen Namen der Standard-Schaltfläche für dieses Nachrichtenfenster an (OK, CANCEL und so weiter). Wenn diese Option nicht angegeben ist, wird die erste Schaltfläche im Dialog zur Standard-Schaltfläche.

detail

Gibt eine zusätzliche Nachricht zur Hauptnachricht an, die von der Option message bereitgestellt wird. Die Nachrichtendetails werden unterhalb der Hauptnachricht angezeigt und, wo vom Betriebssystem unterstützt, in einer weniger hervorgehobenen Schriftart als die Hauptnachricht.

icon

Gibt ein anzuzeigendes Icon an. Wenn diese Option nicht angegeben ist, wird das INFO-Icon angezeigt.

message

Gibt die anzuzeigende Nachricht in diesem Nachrichtenfenster an. Der Standardwert ist eine leere Zeichenkette.

parent

Macht das angegebene Fenster zum logischen Elternteil des Nachrichtenfensters. Das Nachrichtenfenster wird über seinem Elternfenster angezeigt.

title

Gibt eine Zeichenkette an, die als Titel des Nachrichtenfensters angezeigt wird. Diese Option wird unter macOS ignoriert, wo Richtlinien der Plattform Titel für diese Art von Dialogen verbieten.

type

Ordnet eine vordefinierte Gruppe von Schaltflächen zur Anzeige an.

show(**options)

Zeigt ein Nachrichtenfenster an und wartet, bis der Benutzer eine der Schaltflächen auswählt. Gibt dann den symbolischen Namen der ausgewählten Schaltfläche zurück. Schlüsselwortargumente können Optionen überschreiben, die im Konstruktor angegeben wurden.

Informationsnachrichtenfenster

tkinter.messagebox.showinfo(title=None, message=None, **options)

Erstellt und zeigt ein Informationsnachrichtenfenster mit dem angegebenen Titel und der angegebenen Nachricht an.

Warnmeldungsfenster

tkinter.messagebox.showwarning(title=None, message=None, **options)

Erstellt und zeigt ein Warnmeldungsfenster mit dem angegebenen Titel und der angegebenen Nachricht an.

tkinter.messagebox.showerror(title=None, message=None, **options)

Erstellt und zeigt ein Fehlermeldungsfenster mit dem angegebenen Titel und der angegebenen Nachricht an.

Fragenachrichtfenster

tkinter.messagebox.askquestion(title=None, message=None, **options)

Stellt eine Frage. Zeigt standardmäßig die Schaltflächen YES und NO an. Gibt den symbolischen Namen der ausgewählten Schaltfläche zurück.

tkinter.messagebox.askokcancel(title=None, message=None, **options)

Fragt, ob eine Operation fortgesetzt werden soll. Zeigt die Schaltflächen OK und CANCEL an. Gibt True zurück, wenn die Antwort OK ist, und andernfalls False.

tkinter.messagebox.askretrycancel(title=None, message=None, **options)

Fragt, ob eine Operation wiederholt werden soll. Zeigt die Schaltflächen RETRY und CANCEL an. Gibt True zurück, wenn die Antwort Ja ist, und andernfalls False.

tkinter.messagebox.askyesno(title=None, message=None, **options)

Stellt eine Frage. Zeigt die Schaltflächen YES und NO an. Gibt True zurück, wenn die Antwort Ja ist, und andernfalls False.

tkinter.messagebox.askyesnocancel(title=None, message=None, **options)

Stellt eine Frage. Zeigt die Schaltflächen YES, NO und CANCEL an. Gibt True zurück, wenn die Antwort Ja ist, None bei Abbruch und andernfalls False.

Symbolische Namen von Schaltflächen

tkinter.messagebox.ABORT = 'abort'

tkinter.messagebox.RETRY = 'retry'

tkinter.messagebox.IGNORE = 'ignore'

tkinter.messagebox.OK = 'ok'

tkinter.messagebox.CANCEL = 'cancel'

tkinter.messagebox.YES = 'yes'

tkinter.messagebox.NO = 'no'

Vordefinierte Schaltflächen-Sets

tkinter.messagebox.ABORTRETRYIGNORE = 'abortretryignore'

Zeigt drei Schaltflächen an, deren symbolische Namen ABORT, RETRY und IGNORE sind.

tkinter.messagebox.OK = 'ok'

Zeigt eine Schaltfläche an, deren symbolischer Name OK ist.

tkinter.messagebox.OKCANCEL = 'okcancel'

Zeigt zwei Schaltflächen an, deren symbolische Namen OK und CANCEL sind.

tkinter.messagebox.RETRYCANCEL = 'retrycancel'

Zeigt zwei Schaltflächen an, deren symbolische Namen RETRY und CANCEL sind.

tkinter.messagebox.YESNO = 'yesno'

Zeigt zwei Schaltflächen an, deren symbolische Namen YES und NO sind.

tkinter.messagebox.YESNOCANCEL = 'yesnocancel'

Zeigt drei Schaltflächen an, deren symbolische Namen YES, NO und CANCEL sind.

Icon-Bilder

tkinter.messagebox.ERROR = 'error'

tkinter.messagebox.INFO = 'info'

tkinter.messagebox.QUESTION = 'question'

tkinter.messagebox.WARNING = 'warning'