Diálogos Tkinter

tkinter.simpledialog — Diálogos de entrada padrão do Tkinter

Código-fonte: Lib/tkinter/simpledialog.py

O módulo tkinter.simpledialog contém classes de conveniência e funções para criar diálogos modais simples para obter um valor do usuário.

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

As três funções acima fornecem caixas de diálogo que solicitam que o usuário insira um valor do tipo desejado.

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

A classe base para diálogos personalizados.

body(master)

Substitui para construir a interface da caixa de diálogo e retornar o widget que deve ter foco inicial.

buttonbox()

O comportamento padrão adiciona botões OK e Cancelar. Substitua para layouts de botão personalizados.

tkinter.filedialog — Caixas de diálogo de seleção de arquivo

Código-fonte: Lib/tkinter/filedialog.py

The módulo tkinter.filedialog fornece classes e funções de fábrica para criar janelas de seleção de arquivo/diretório.

Caixas de diálogo nativos de carregar/salvar

As seguintes classes e funções fornecem janelas de diálogo de arquivo que combinam uma aparência nativa com opções de configuração para personalizar o comportamento. Os seguintes argumentos nomeados são aplicáveis às classes e funções listado abaixo:

parent - a janela para colocar a caixa de diálogo no topo
title - o título da janela
initialdir - o diretório no qual a caixa de diálogo começa
initialfile - o arquivo selecionado ao abrir a caixa de diálogo
filetypes - uma sequência de tuplas (rótulo, padrão), o caractere curinga ‘*’ é permitido
defaultextension - extensão padrão para anexar ao arquivo (caixas de diálogo para salvar)
multiple - quando verdadeiro, a seleção de vários itens é permitida

Fábrica de funções estáticas

As funções a seguir, quando chamadas, criam uma caixa de diálogo modal e nativa, aguardam a seleção do usuário e, em seguida, retornam o(s) valor(es) selecionado(s) ou None para o chamador.

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

As duas funções acima criam uma caixa de diálogo Open e retornam a caixa de diálogo com um ou mais objetos arquivo abertos em modo somente leitura.

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

Cria uma caixa de diálogo SaveAs e retorna um objeto arquivo aberto em modo somente escrita.

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

As duas funções acima criam uma caixa de diálogo Open e retornam um ou mais nomes de arquivos selecionados que correspondem aos arquivos existentes.

tkinter.filedialog.asksaveasfilename(**options)

Cria uma caixa de diálogo SaveAs e retorna o nome do arquivo selecionado.

tkinter.filedialog.askdirectory(**options)
Solicita ao usuário que selecione um diretório.
Opção de palavra reservada adicional:
mustexist - determina se a seleção deve ser um diretório existente.
class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)

As duas classes acima fornecem janelas de diálogo nativas para salvar e carregar files.

Classes de conveniência

As classes abaixo são usadas para criar janelas de arquivos/diretórios desde o início. Elas não emulam a aparência nativa da plataforma.

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

Cria uma caixa de diálogo solicitando que o usuário selecione um diretório.

Nota

A classe FileDialog deve ser uma subclasse para manipulação e comportamento de eventos personalizados.

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

Cria uma caixa de diálogo básica de seleção de arquivo.

cancel_command(event=None)

Aciona o encerramento da janela de diálogo.

dirs_double_event(event)

Manipulador de eventos para evento de clique duplo no diretório.

dirs_select_event(event)

Manipulador de eventos para evento de clique no diretório.

files_double_event(event)

Manipulador de eventos para evento de clique duplo no arquivo.

files_select_event(event)

Manipulador de eventos para evento de clique único no arquivo.

filter_command(event=None)

Filtra os arquivos por diretório.

get_filter()

Recupera o filtro de arquivo atualmente em uso.

get_selection()

Recupera o item atualmente selecionado.

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

Caixa de diálogo de renderização e inicia um laço de eventos.

ok_event(event)

Sai da caixa de diálogo retornando a seleção atual.

quit(how=None)

Sai da caixa de diálogo retornando o nome do arquivo, se houver.

set_filter(dir, pat)

Define o filtro de arquivo.

set_selection(file)

Atualiza a seleção de arquivo atual para file.

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

Uma subclasse de FileDialog que cria uma janela de diálogo para selecionar um arquivo existente.

ok_command()

Testa se um arquivo é fornecido e se a seleção indica um já arquivo existente.

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

Uma subclasse de FileDialog que cria uma janela de diálogo para selecionar um arquivo de destino.

ok_command()

Testa se a seleção aponta ou não para um arquivo válido que não é um diretório. A confirmação é necessária se um arquivo já existente for selecionado.

tkinter.commondialog — Modelos de janela de diálogo

Código-fonte: Lib/tkinter/commondialog.py

O módulo tkinter.commondialog fornece a a classe Dialog, que é a classe base para diálogos definidos em outros módulos de suporte.

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

Renderiza a janela de diálogo.

Ver também

Módulos tkinter.messagebox, Leitura e escrita de arquivos