tkinter.messagebox
— Prompts de mensagem do Tkinter¶
Código-fonte: Lib/tkinter/messagebox.py
O módulo tkinter.messagebox
provê uma classe base template e uma variedade de métodos de conveniência para as configurações mais comumente usadas. As caixas de mensagem são modais e vão retornar um conjuto de (True
, False
, None
, OK
, CANCEL
, YES
, NO
) baseado na seleção do usuário. Estilos e formatos de janelas comuns estão incluidos, mas não estão limitados a:
- class tkinter.messagebox.Message(master=None, **options)¶
Criar uma janela de mensagem com uma mensagem específica da aplicação, um ícone e um conjunto de botões. Cada botão na janela é identificado com um nome simbólico único (veja as opções de “type”).
As seguintes opções são suportadas:
- “command”
Especifica a função que será invocada quando o usuário fecha a janela de dálogo. O nome do botão clicado pelo usuário para fechar a janela é passada como um argumento. Esta funcionalidade está disponível apenas no macOS.
- “default”
Fornece o nome simbólico do botão padrão para essa janela de mensagem (
OK
,CANCEL
, e assim por diante). Se essa opção não for especificada, o primeiro botão da caixa de diálogo será o padrão.- “detail”
Especifica uma mensagem auxiliar para a mensagem principal fornecida pela opção message. Esta mensagem será apresentado abaixo da mensagem principal e, quando suportado pelo sistema operacional, em uma fonte menos enfatizada do que a mensagem principal.
- “icon”
Especifica um icon a ser apresentado. Se essa opção não for especificada, o ícone
INFO
será exibido.- “message”
Especifica a mensagem para mostrar nessa caixa de mensagem. O padrão valor é uma string vazia.
- “parent”
Torna a janela especificada a janela pai da caixa de mensagem. A caixa de mensagem é exibida na parte superior de sua janela pai.
- “title”
Especifica uma string para mostrar como o título da caixa de mensagem. Essa opção é ignorada no macOS, onde a plataforma proíbe o uso de um título nesse tipo de caixa de diálogo.
- “type”
Organiza um conjunto predefinido de botões a serem mostrados.
- show(**options)¶
Mostra uma janela de mensagem e aguarda que o usuário selecione um dos botões. Em seguida, retorna o nome simbólico do botão selecionado. Argumentos nomeados pode substituir opções especificadas no construtor.
Caixa de mensagem de informação
- tkinter.messagebox.showinfo(title=None, message=None, **options)¶
Cria e exibe uma caixa de mensagem informativa com o título e a mensagem especificados.
Caixas de mensagem de atenção
- tkinter.messagebox.showwarning(title=None, message=None, **options)¶
Cria e exibe uma caixa de mensagem de alerta com o título e a mensagem especificados.
- tkinter.messagebox.showerror(title=None, message=None, **options)¶
Cria e exibe uma caixa de mensagem de erro com o título e a mensagem especificados.
Caixas de mensagem de dúvida
- tkinter.messagebox.askquestion(title=None, message=None, *, type=YESNO, **options)¶
Faz uma pergunta. Por padrão mostra os botões
YES
eNO
. Retorna o nome simbólico do botão selecionado.
- tkinter.messagebox.askokcancel(title=None, message=None, **options)¶
Pergunta se a operação deve prosseguir. Mostra os botões
OK
eCANCEL
. RetornaTrue
se a resposta for “OK” eFalse
caso contrário.
- tkinter.messagebox.askretrycancel(title=None, message=None, **options)¶
Pergunta se a operação deve ser tentada novamente. Mostra os botões
RETRY
eCANCEL
. RetornaTrue
se a resposta for sim eFalse
caso contrário.
- tkinter.messagebox.askyesno(title=None, message=None, **options)¶
Faz uma pergunta. Mostra os botões
YES
eNO
. RetornaTrue
se a resposta for sim eFalse
caso contrário.
- tkinter.messagebox.askyesnocancel(title=None, message=None, **options)¶
Faz uma pergunta. Mostra os botões
YES
,NO
eCANCEL
. RetornaTrue
se a resposta for sim,None
se cancelado, eFalse
caso contrário.
- tkinter.messagebox.ABORT = 'abort'¶
- tkinter.messagebox.RETRY = 'retry'¶
- tkinter.messagebox.IGNORE = 'ignore'¶
- tkinter.messagebox.OK = 'ok'¶
- tkinter.messagebox.CANCEL = 'cancel'¶
- tkinter.messagebox.YES = 'yes'¶
- tkinter.messagebox.NO = 'no'¶
Conjunto predefinido de botões:
- tkinter.messagebox.ABORTRETRYIGNORE = 'abortretryignore'¶
Exibe três botões cujos nomes simbólicos são
ABORT
,RETRY
eIGNORE
.
- tkinter.messagebox.OK = 'ok'
Exibe um botão cujo nome simbólico é
OK
.
- tkinter.messagebox.RETRYCANCEL = 'retrycancel'¶
Exibe dois botões cujos nomes simbólicos são
RETRY
eCANCEL
.
- tkinter.messagebox.YESNOCANCEL = 'yesnocancel'¶
Exibe três botões cujos nomes simbólicos são
YES
,NO
eCANCEL
.
Imagens de ícones:
- tkinter.messagebox.ERROR = 'error'¶
- tkinter.messagebox.INFO = 'info'¶
- tkinter.messagebox.QUESTION = 'question'¶
- tkinter.messagebox.WARNING = 'warning'¶