TkInter - de marciano a humano - sección 9 - El Widget Checkbutton

 

9. El widget Checkbutton

El propósito de un widget de botón de verificación (a veces llamado "casilla de verificación") es permitir al usuario leer y seleccionar una opción de dos vías. El gráfico anterior muestra cómo se ven los botones de verificación en el estado apagado (0) y encendido (1).

El indicador es la parte del botón de verificación que muestra su estado, y la etiqueta es el texto que aparece a su lado.

- Deberá crear una variable de control, una instancia de la clase IntVar, para que su programa pueda consultar y establecer el estado del botón de verificación. Consulte la Sección 52.

- También puede usar enlaces de eventos para reaccionar a las acciones del usuario en el botón de verificación, vea la Sección 54.

- Puede deshabilitar un botón de verificación. Esto cambia su apariencia a "atenuada" y hace que no responda al mouse.

- Puede deshacerse del indicador del botón de verificación y hacer que todo el widget sea un botón "push-push" que parece empotrado cuando se configura, y se ve elevado cuando se borra.

Para crear un botón de verificación en una ventana padre o marco padre existente:

w=tk.Checkbutton(parent, option, ...)

El constructor devuelve un nuevo widget Checkbutton. Las opciones incluyen:

Tabla 16. Opciones de widget de botón de verificación
activebackground	Color de fondo cuando el botón de verificación está debajo del cursor. Ver la Sección 5.3.
activeforeground	Color de primer plano cuando el botón de verificación está debajo del cursor.
anchor	Si el widget habita un espacio más grande de lo que necesita, esta opción especifica donde el botón de verificación se sentará en ese espacio. El valor predeterminado es anchor=tk.CENTER. Consulte la Sección 5.5. Por ejemplo, si usa anchor=NW, el widget se colocará en la esquina superior izquierda del espacio.
bg o background	El color de fondo normal que se muestra detrás de la etiqueta y el indicador. Ver Sección 5.3, esto especifica el color mostrado para 0 bits en el bitmap.
bitmap	Para mostrar una imagen monocroma en un botón, establezca esta opción en un bitmap, consulte la Sección 5.7.
bd o borderwidth	El tamaño del borde alrededor del indicador. El valor predeterminado es dos píxeles. Consulte la Sección 5.1.
command	Se llamará a un procedimiento cada vez que el usuario cambie el estado de este botón de control compuesto (checkbutton).
compound	Use esta opción para mostrar tanto texto como un gráfico, que puede ser un mapa de bits o una imagen, en el botón. Los valores permitidos describen la posición del gráfico relativo al texto, y puede ser cualquiera de tk.BOTTOM, tk.TOP, tk.LEFT, tk.RIGHT o tk.CENTER. Por ejemplo, compound=tk.LEFT posicionaría el gráfico a la izquierda del texto.
cursor	Si establece esta opción en un nombre de cursor (consulte la Sección 5.8), el cursor del mouse cambiará a ese patrón cuando esté sobre el botón de verificación.
disabledforeground	El color de primer plano utilizado para representar el texto de un botón de verificación deshabilitado. default es la versión punteada del color de primer plano predeterminado.
font	La fuente utilizada para el texto. Consulte la Sección 5.4.
fg o foreground	El color utilizado para representar el texto. Para la opción de bitmap, esto especifica el color que se muestra para 1 bits en el mapa de bits.
height	El número de líneas de texto en el botón de verificación. El valor predeterminado es 1. highlightbackground es el color del foco resaltado cuando el botón de verificación no tiene foco. Consulte la Sección 53.
highlightbackground	El color del foco se resalta cuando el botón de verificación no tiene foco. Ver sección 53.
higlightcolor	El color del foco se resalta cuando el botón de verificación tiene el foco.
higlightthickness	El grosor del foco resaltado. El valor predeterminado es 1. Establecer en 0 para suprimir la visualización del foco de atención.
image	Para mostrar una imagen gráfica en el botón, establezca esta opción en un objeto de imagen. Consulte la Sección 5.9.
indicatoron	Normalmente, un botón de verificación muestra como indicador un cuadro que muestra si el botón de verificación está configurado o no. Puede obtener este comportamiento configurando indicatoron=1. Sin embargo, si establece el indicador en indicatoron=0, el indicador desaparece, y todo el widget se convierte en un botón que parece elevado cuando se borra y se hunde cuando se configura. Es posible que desee aumentar el borderwidth value para que sea más fácil ver el estado de dicho control.
justify	Si el texto contiene varias líneas, esta opción controla cómo se ajusta el texto. Sus opciones son tk.CENTER, tk.LEFT o tk.RIGHT.
offrelief	De forma predeterminada, los botones de verificación usan el estilo de relieve tk.RAISED cuando el botón está apagado (despejado), use esta opción para especificar un estilo de relieve diferente que se deshabilitará cuando el botón está apagado. Consulte la Sección 5.6.
offvalue	Normalmente, la variable de control asociada de un botón de verificación se establecerá en 0 cuando está despejado (apagado). Puede proporcionar un valor alternativo para el estado desactivado estableciendo offvalue en ese valor.
onvalue	Normalmente, la variable de control asociada de un botón de verificación se establecerá en 1 cuando está configurado (encendido). Puede proporcionar un valor alternativo para el estado activado configurando valor a ese valor.
overrelif	Use esta opción para especificar un estilo de relieve que se mostrará cuando el mouse esté sobre el botón de verificación, consulte la Sección 5.6.
padx	Cuánto espacio dejar a la izquierda y a la derecha del botón de verificación y el texto. El valor predeterminado es 1 píxel. Para conocer los posibles valores, consulte la Sección 5.1.
pady	Cuánto espacio dejar arriba y debajo del botón de verificación y el texto. por defecto el valor es 1 píxel.
relief	Con el valor predeterminado, relief=tk.FLAT, el botón de verificación no se coloca fuera de su fondo. Puede establecer esta opción en cualquiera de los otros estilos, consulte la Sección 5.6 o use relief=tk.SOLID, que le dará un marco negro sólido a su alrededor.
selectcolor	El color del botón de verificación cuando está configurado. El valor predeterminado es selectcolor='red'.
selectimage	Si configura esta opción en una imagen, esa imagen aparecerá en el botón de verificación cuando se establece. Consulte la Sección 5.9.
state	El valor predeterminado es state=tk.NORMAL, pero puede usar state=tk.DISABLED para atenuar el control y hacer que no responda. Si el cursor está actualmente sobre el botón de verificación, el estado es tk.ACTIVE.
takefocus	El valor predeterminado es que el foco de entrada (consulte la Sección 53) pasará por un botón de verificación. Si establece takefocus=0, el foco no lo atravesará.
text	La etiqueta que se muestra al lado del botón de verificación. Use líneas nuevas '\n' para mostrar múltiples líneas de texto.
textvariable	Si necesita cambiar la etiqueta de un botón de verificación durante la ejecución, cree un StringVar (consulte la Sección 52) para administrar el valor actual y establecer esta opción en ese control variable. Cada vez que cambia el valor de la variable de control, el botón de verificación la anotación también cambiará automáticamente.
underline	Con el valor predeterminado de -1, ninguno de los caracteres de la etiqueta de texto es subrayado. Establezca esta opción en el índice de un carácter en el texto (contando de cero) para subrayar ese carácter.
variable	La variable de control que rastrea el estado actual del botón de verificación, ver Sección 52. Normalmente esta variable es una IntVar, el valor 0 significa despejado y 1 significa establecer, pero vea las opciones de offvalue y onvalue más arriba.
width	El ancho predeterminado de un botón de verificación está determinado por el tamaño del imagen o texto. Puede establecer esta opción en varios caracteres y el botón de verificación siempre tendrá espacio para tantos caracteres.
wraplength	Normalmente, las líneas no están envueltas. Puede establecer esta opción en un número de caracteres y todas las líneas se dividirán en pedazos no más largos que eso número.

Los métodos en los botones de verificación incluyen:

.deselect(): Borra (apaga) el botón de verificación.

.flash(): Parpadea el botón de verificación varias veces entre sus colores activo y normal, pero lo deja como comenzó.

.invoke(): Puede llamar a este método para obtener las mismas acciones que ocurrirían si el usuario hiciera clic en el botón de verificación para cambiar su estado.

.select(): Establece (enciende) el botón de verificación.

.toggle(): Borra el botón de verificación si está configurado, lo establece si está borrado.

Hasta el próximo jueves, salud y saludos!

Mauricio José Tobares