TUTORIAL · Tkinter
Tkinter Tutorial - Combobox
Tutorial da combobox Python Tkinter
Nesta página
Um ttk.Combobox é um campo do Tkinter com uma lista suspensa de opções. Defina sua opção values para preencher a lista, chame current(index) para selecionar por posição e use get() para ler o texto exibido. Uma lista preenchida não seleciona seu primeiro item automaticamente. O breve exemplo em Python abaixo ilustra a relação entre índice e texto sem criar uma janela; os trechos reais de widgets neste guia são mostrados em linha porque o ambiente de execução fornecido não tem exibição gráfica. Para callbacks de seleção, vincule o nome exato do evento virtual <<ComboboxSelected>> para que seu manipulador responda quando um usuário escolher um item. (<<ComboboxSelected>>)
Exemplo de ttk.Combobox do Python Tkinter
Este pequeno exemplo mostra como uma seleção explícita corresponde à sua posição e ao seu texto exibido. Ele é executado sem abrir uma janela Tk.
months = ["January", "February", "March", "April"]
selected_index = 1
selected_text = months[selected_index]
print(selected_index, selected_text)
1 February
Para um widget, importe ttk com from tkinter import ttk, crie-o com ttk.Combobox(parent, values=months) e defina a escolha inicial com combo.current(1). O método current() sem argumento retorna o índice do item selecionado; get() retorna seu texto exibido. No estado padrão normal, um usuário pode digitar um valor que não está na lista: get() retorna então esse texto e current() retorna -1 quando ele não corresponde a um item da lista.
Definir as fontes da combobox e de sua lista
A opção font estiliza o campo da Combobox. Sua lista suspensa é uma listbox Tk separada, portanto configure essa lista com o padrão de opção *TCombobox*Listbox.font. Por exemplo, crie uma tupla de fonte como ("Courier", 16, "bold") para o campo e, em seguida, defina a opção da janela raiz com app.option_add("*TCombobox*Listbox.font", ("Courier", 14)) antes de abrir a lista. Use tuplas separadas quando o campo e a lista precisarem de tamanhos ou pesos diferentes. A disponibilidade das famílias de fontes depende do sistema operacional, que pode substituí-la por uma fonte instalada.
Definir apenas o font da Combobox pode deixar o texto da lista em sua fonte padrão do sistema. Configure a opção da listbox antes que a lista suspensa seja aberta pela primeira vez, para que ambas as partes do controle usem o estilo pretendido.
Vincular um callback a uma seleção da combobox
O Tkinter nomeia o evento virtual de seleção <<ComboboxSelected>>. Vincule esse nome exato com combo.bind("<<ComboboxSelected>>", show_selection) para executar uma função depois que um usuário escolher um item da lista. Defina o callback para aceitar o objeto de evento do Tkinter, por exemplo def show_selection(event): print("Selected:", event.widget.get()). Quando o usuário escolhe March, o callback imprime Selected: March. O evento é gerado por uma seleção do usuário a partir da lista; definir um valor no código com current() não representa um usuário selecionando um item.
O callback lê o widget que emitiu o evento por meio de event.widget, portanto também pode ser reutilizado para mais de uma Combobox, se necessário. Mantenha o callback focado na resposta a uma seleção, como atualizar um rótulo relacionado ou recalcular um valor de formulário.
Atualizar os valores da combobox antes de a lista abrir
Use a opção postcommand quando as opções devam ser atualizadas cada vez que o usuário abrir a lista suspensa. O Tkinter chama a função atribuída imediatamente antes de exibir a lista, permitindo que ela substitua combo["values"]. Por exemplo, uma função refresh_months() pode atribuir ["July", "August", "September", "October"]; passe-a ao construtor como postcommand=refresh_months.
O postcommand é executado antes de a lista ser mostrada, não quando a janela é criada. A lista inicial pode conter de January a April, e então sua primeira abertura atualiza as opções disponíveis para de July a October. O texto exibido não se torna automaticamente uma seleção apenas porque as opções mudaram. Mantenha o callback rápido porque ele é executado como parte da abertura da lista suspensa.
Tornar a combobox somente leitura ou desabilitada
Uma Combobox usa state="normal" por padrão, o que permite ao usuário digitar em seu campo e escolher um item da lista. Defina state="readonly" para impedir a digitação, mas ainda permitir uma escolha da lista. Defina state="disabled" quando o controle deve estar indisponível; o Tkinter o renderiza como inativo e impede a interação. Por exemplo, crie controles com ttk.Combobox(app, values=months, state="normal"), state="readonly" ou state="disabled" para comparar esses modos em uma janela.
Use readonly quando um valor deve vir das opções oferecidas, mas o usuário ainda deve poder alterá-lo. Use disabled quando o valor estiver temporariamente indisponível ou o controle for informativo. Uma Combobox desabilitada não pode ser aberta nem editada; alterar seu estado de volta para normal ou readonly restaura a interação. Para mais widgets do Tkinter que podem acompanhar um formulário, consulte o tutorial de Tkinter Entry e o tutorial de Tkinter Button.