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.
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 topotitle - o título da janelainitialdir - o diretório no qual a caixa de diálogo começainitialfile - o arquivo selecionado ao abrir a caixa de diálogofiletypes - uma sequência de tuplas (rótulo, padrão), o caractere curinga ‘*’ é permitidodefaultextension - 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