Tkinter-dialogrutor

tkinter.simpledialog — Tkinters standardinmatningsdialoger

Källkod: Lib/tkinter/simpledialog.py

Modulen tkinter.simpledialog innehåller bekvämlighetsklasser och funktioner för att skapa enkla modala dialogrutor för att få ett värde från användaren.

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

De tre ovanstående funktionerna ger dialogrutor som uppmanar användaren att ange ett värde av önskad typ.

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

Basklass för anpassade dialogrutor.

body(master)

Överstyrning för att konstruera dialogrutans gränssnitt och returnera den widget som ska ha första fokus.

buttonbox()

Standardbeteende lägger till OK- och Avbryt-knappar. Åsidosätt för anpassade knapplayouter.

tkinter.filedialog — Dialogrutor för filval

Källkod: Lib/tkinter/filedialog.py

Modulen tkinter.filedialog tillhandahåller klasser och fabriksfunktioner för att skapa fönster för val av filer och kataloger.

Inbyggda dialogrutor för ladda/spara

Följande klasser och funktioner tillhandahåller fildialogfönster som kombinerar ett inbyggt utseende och en inbyggd funktion med konfigurationsalternativ för att anpassa beteendet. Följande nyckelordsargument är tillämpliga på klasserna och funktionerna som listas nedan:

parent - fönstret som dialogrutan ska placeras ovanpå
title - titeln på fönstret
initialdir - den katalog som dialogrutan startar i
initialfile - den fil som väljs när dialogrutan öppnas
filetypes - en sekvens av (label, pattern)-tupler, jokertecken ”*” är tillåtet
defaultextension - standardtillägg att lägga till i filen (spara dialogrutor)
multiple - när true, är det tillåtet att välja flera objekt

Statiska fabriksfunktioner

Nedanstående funktioner skapar en modal dialogruta med inbyggt utseende och känsla, väntar på användarens val och returnerar sedan det/de valda värdena eller None till den som anropar.

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

De två ovanstående funktionerna skapar en Open-dialogruta och returnerar det/de öppnade filobjekten i skrivskyddat läge.

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

Skapa en SaveAs-dialogruta och returnera ett filobjekt som öppnats i skrivskyddat läge.

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

Ovanstående två funktioner skapar en Open-dialogruta och returnerar det eller de valda filnamn som motsvarar befintliga filer.

tkinter.filedialog.asksaveasfilename(**options)

Skapa en SaveAs-dialogruta och returnera det valda filnamnet.

tkinter.filedialog.askdirectory(**options)
Fråga användaren om att välja en katalog.
Ytterligare sökordsalternativ:
mustexist - avgör om urvalet måste vara en befintlig katalog.
class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)

De två ovanstående klasserna tillhandahåller inbyggda dialogfönster för att spara och ladda filer.

Bekvämlighetskurser

Nedanstående klasser används för att skapa fil-/katalogfönster från grunden. Dessa emulerar inte plattformens ursprungliga utseende och känsla.

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

Skapa en dialogruta där användaren uppmanas att välja en katalog.

Anteckning

Klassen FileDialog bör underklassificeras för anpassad händelsehantering och beteende.

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

Skapa en enkel dialogruta för filval.

cancel_command(event=None)

Utlös avslutning av dialogfönstret.

dirs_double_event(event)

Händelsehanterare för dubbelklick på katalog.

dirs_select_event(event)

Händelsehanterare för klickhändelse på katalog.

files_double_event(event)

Händelsehanterare för dubbelklick på fil.

files_select_event(event)

Händelsehanterare för enkelklickshändelse på fil.

filter_command(event=None)

Filtrera filerna efter katalog.

get_filter()

Hämta det filfilter som används för närvarande.

get_selection()

Hämta det objekt som för tillfället är valt.

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

Rendera dialogrutan och starta händelseslingan.

ok_event(event)

Avsluta dialogrutan och returnera aktuellt val.

quit(how=None)

Avsluta dialogrutan och returnera filnamnet, om det finns något.

set_filter(dir, pat)

Ställ in filfiltret.

set_selection(file)

Uppdatera det aktuella filvalet till fil.

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

En subklass av FileDialog som skapar ett dialogfönster för att välja en befintlig fil.

ok_command()

Testa att en fil tillhandahålls och att valet indikerar en redan befintlig fil.

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

En subklass av FileDialog som skapar ett dialogfönster för att välja en destinationsfil.

ok_command()

Testa om markeringen pekar på en giltig fil som inte är en katalog. Bekräftelse krävs om en redan befintlig fil väljs.

tkinter.commondialog — Mallar för dialogfönster

Källkod: Lib/tkinter/commondialog.py

Modulen tkinter.commondialog tillhandahåller klassen Dialog som är basklass för dialogrutor som definieras i andra stödmoduler.

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

Rendera dialogfönstret.

Se även

Moduler tkinter.messagebox, Läsa och skriva filer