# 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