TUTORIAL · Tkinter
Tutorial de Tkinter - Combobox
Tutorial del combobox de Python Tkinter
En esta página
Un ttk.Combobox es un campo de Tkinter con una lista desplegable de opciones. Establece su opción values para llenar la lista, llama a current(index) para seleccionar por posición y usa get() para leer el texto mostrado. Una lista llena no selecciona su primer elemento automáticamente. El breve ejemplo de Python siguiente ilustra la relación entre el índice y el texto sin crear una ventana; los fragmentos reales de widgets de esta guía se muestran en línea porque el entorno de ejecución proporcionado no tiene pantalla gráfica. Para los callbacks de selección, enlaza el nombre exacto del evento virtual <<ComboboxSelected>> para que tu controlador responda cuando un usuario elija un elemento. (<<ComboboxSelected>>)
Ejemplo de ttk.Combobox de Python Tkinter
Este pequeño ejemplo muestra cómo una selección explícita se corresponde con su posición y su texto mostrado. Se ejecuta sin abrir una ventana Tk.
months = ["January", "February", "March", "April"]
selected_index = 1
selected_text = months[selected_index]
print(selected_index, selected_text)
1 February
Para un widget, importa ttk con from tkinter import ttk, créalo con ttk.Combobox(parent, values=months) y establece la elección inicial con combo.current(1). El método current() sin argumento devuelve el índice del elemento seleccionado; get() devuelve su texto mostrado. En el estado predeterminado normal, un usuario puede escribir un valor que no está en la lista: get() devuelve entonces ese texto y current() devuelve -1 cuando no coincide con un elemento de la lista.
Establecer las fuentes del combobox y su lista
La opción font da estilo al campo del Combobox. Su lista desplegable es un listbox de Tk independiente, así que configura esa lista con el patrón de opción *TCombobox*Listbox.font. Por ejemplo, crea una tupla de fuente como ("Courier", 16, "bold") para el campo y luego establece la opción de la ventana raíz con app.option_add("*TCombobox*Listbox.font", ("Courier", 14)) antes de abrir la lista. Usa tuplas separadas cuando el campo y la lista necesiten tamaños o grosores diferentes. La disponibilidad de las familias de fuentes depende del sistema operativo, que puede sustituirla por una fuente instalada.
Establecer solo el font del Combobox puede dejar el texto de la lista en su fuente predeterminada del sistema. Configura la opción del listbox antes de que la lista desplegable se abra por primera vez para que ambas partes del control usen el estilo deseado.
Enlazar un callback a una selección del combobox
Tkinter nombra el evento virtual de selección <<ComboboxSelected>>. Enlaza ese nombre exacto con combo.bind("<<ComboboxSelected>>", show_selection) para ejecutar una función después de que un usuario elija un elemento de la lista. Define el callback para que acepte el objeto de evento de Tkinter, por ejemplo def show_selection(event): print("Selected:", event.widget.get()). Cuando el usuario elige March, el callback imprime Selected: March. El evento se genera por una selección del usuario desde la lista; establecer un valor en el código con current() no representa que un usuario seleccione un elemento.
El callback lee el widget que emitió el evento a través de event.widget, por lo que también puede reutilizarse para más de un Combobox si es necesario. Mantén el callback centrado en la respuesta a una selección, como actualizar una etiqueta relacionada o recalcular un valor de formulario.
Actualizar los valores del combobox antes de que se abra la lista
Usa la opción postcommand cuando las opciones deban actualizarse cada vez que el usuario abra la lista desplegable. Tkinter llama a la función asignada inmediatamente antes de mostrar la lista, lo que le permite reemplazar combo["values"]. Por ejemplo, una función refresh_months() puede asignar ["July", "August", "September", "October"]; pásala al constructor como postcommand=refresh_months.
postcommand se ejecuta antes de que se muestre la lista, no cuando se crea la ventana. La lista inicial puede contener de January a April, y luego su primera apertura actualiza las opciones disponibles a de July a October. El texto mostrado no se convierte automáticamente en una selección solo porque las opciones hayan cambiado. Mantén el callback rápido porque se ejecuta como parte de la apertura de la lista desplegable.
Hacer el combobox de solo lectura o deshabilitarlo
Un Combobox usa state="normal" por defecto, lo que permite al usuario escribir en su campo y elegir un elemento de la lista. Establece state="readonly" para impedir la escritura y seguir permitiendo una elección de la lista. Establece state="disabled" cuando el control deba estar no disponible; Tkinter lo representa como inactivo e impide la interacción. Por ejemplo, crea controles con ttk.Combobox(app, values=months, state="normal"), state="readonly" o state="disabled" para comparar estos modos en una ventana.
Usa readonly cuando un valor deba proceder de las opciones ofrecidas pero el usuario aún deba poder cambiarlo. Usa disabled cuando el valor no esté disponible temporalmente o el control sea informativo. Un Combobox deshabilitado no puede abrirse ni editarse; cambiar su estado de nuevo a normal o readonly restaura la interacción. Para más widgets de Tkinter que pueden acompañar a un formulario, consulta el tutorial de Tkinter Entry y el tutorial de Tkinter Button.