Esta documentação é de uma versão antiga do Python que não é mais atualizada. Você deveria atualizar e ler a Documentação do Python para versão estável atual.

# 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