Add files via upload

Author: juan-suarezp

README.md

@@ -0,0 +1,121 @@
+# Tkinter
+Tkinter es una librería de Python que permite crear interfaz gráfica de usuario (GUI en inglés). Es la librería que viene por defecto con la instalación de Python; esto no significa que otras alternativas, como por ejemplo PyQt, sean más potentes que Tkinter.
+
+## GUI con Tkinter
+El primer paso para crear una GUI es crear la ventana principal como se muestra en el siguiente código:
+
+```python
+import tkinter as tk
+
+ventana = tk.Tk()
+ventana.mainloop()
+```
+
+El resultado es el siguiente:
+
+![Ventana Tkinter](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/ventana.png)
+
+Un programa solo puede tener una `Tk`, debido a que es la raiz del programa y el primer widget que se debe crear; por lo tanto, cerrar la `Tk` cerraría la GUI. Existen otro tipo de ventanas llamadas `Toplevel` que son ventanas de la aplicación, la diferencia con la `Tk` es que al cerrar una ventana `Toplevel` destruirá todos los widgets secundarios colocados en esa ventana pero no cerrará el programa. 
+
+Una vez se tiene la ventana principal, lo siguiente es agregar los botones, entradas, labels y demás widgets que necesitemos. Para esto, Tkinter cuenta con tres mecanismos para gestionar la geometría de los widgets de nuestra GUI: los métodos `pack()`, `grid()` y `place()`.
+
+### Pack
+Este mecanismo para gestionar la geometría de los widgets los organiza en bloques antes de ubicarlos en el widget principal. Veamos un ejemplo simple con algunos botones:
+
+```python
+import tkinter as tk
+
+ventana = tk.Tk()
+
+boton1 = tk.Button(ventana, text="1")
+boton1.pack(side="top")
+boton2 = tk.Button(ventana, text="2")
+boton2.pack(side="top")
+boton3 = tk.Button(ventana, text="3")
+boton3.pack(side="left")
+boton4 = tk.Button(ventana, text="4")
+boton4.pack(side="bottom")
+
+ventana.mainloop()
+```
+![ventana botones pack](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/ventanapack.png)
+
+Se puede observar que se respeta el orden en que se "empacan" los widgets. Esto se observa claramente con los botones 1 y 2, los cuales tienen `side = "top"`, como el botón 1 está primero, se respeta y queda sobre el botón 2 que después queda sobre los widgets que se ubiquen después. Es un método muy útil cuando se va a crear una aplicación con pocos widgets.
+
+[Aquí](https://www.tutorialspoint.com/python/tk_pack.htm) para ver más sobre el método pack.
+
+### Grid
+Este mecanismo para gestionar la geometría de los widgets los organiza en una tabla en el widget principal. Veamos el ejemplo anterior con este método:
+
+```python
+import tkinter as tk
+
+ventana = tk.Tk()
+
+boton1 = tk.Button(ventana, text="1")
+boton1.grid(row=0, column=0)
+boton2 = tk.Button(ventana, text="2")
+boton2.grid(row=1, column=1)
+boton3 = tk.Button(ventana, text="3")
+boton3.grid(row=2, column=2)
+boton4 = tk.Button(ventana, text="4")
+boton4.grid(row=3, column=3)
+
+ventana.mainloop()
+```
+![ventana botones grid](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/ventanagrid.png)
+
+Este método permite ubicar los widgets indicando la fila y la columna. Por defecto, el tamaño de las filas y columnas está dado por los widgets que estén ubicados en ellas, pero es posible cambiar el tamaño y combinar filas o columnas. Este método es muy útil cuando las aplicaciones contienen muchos widgets.
+
+[Aquí](https://www.tutorialspoint.com/python/tk_grid.htm) para ver más sobre el método grid.
+
+### Place
+Este mecanismo para gestionar la geometría de los widgets permite ubicarlos en una posición específica en el widget principal. continuando con el ejemplo anterior:
+
+```python
+import tkinter as tk
+
+ventana = tk.Tk()
+
+boton1 = tk.Button(ventana, text="1")
+boton1.place(x=0, y=0)
+boton2 = tk.Button(ventana, text="2")
+boton2.place(x=100, y=0)
+boton3 = tk.Button(ventana, text="3")
+boton3.place(x=100, y=100)
+boton4 = tk.Button(ventana, text="4")
+boton4.place(x=0, y=100)
+
+ventana.mainloop()
+```
+![ventana botones place](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/ventanaplace.png)
+
+Este método tiene la ventaja de que permite ubicar exactamente donde se quiere los widgets, pero hay que tener cuidado con su tamaño. Cuando son muchos widgets se vuelve problemático ubicarlos todos.
+
+[Aquí](https://www.tutorialspoint.com/python/tk_place.htm) para ver más sobre el método place.
+
+## Widgets Tkinter
+Tkinter cuenta con un gran número de widgets, a continuación están listados los más usados (seleccionar para ver ejemplo de cada uno):
+- [Button.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/button.md)
+- [Canvas.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/canvas/canvas.md)
+- [Checkbutton.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/checkbutton/checkbutton.md)
+- [ColorchooserP.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/colorchooser/colorchooser.md)
+- [Combobox.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/combobox/combobox.md)
+- [Entry.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/entry/entry.md)
+- [FiledialogP.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/filedialog/filedialog.md)
+- [Frame.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/frame/frame.md)
+- [Label.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/label/label.md)
+- [Labelframe.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/labelframe/labelframe.md)
+- [Listbox.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/listbox/listbox.md)
+- [Menu.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/menu/menu.md)
+- [Menubutton.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/menubutton/menubutton.md)
+- [Message.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/message/message.md)
+- [MessageboxP.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/messagebox/messagebox.md)
+- [Notebook.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/notebook/notebook.md)
+- [Panedwindow.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/panedwindow/panedwindow.md)
+- [Progressbar.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/progressbar/progressbar.md)
+- [Radiobutton.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/radiobutton/radiobutton.md)
+- [Scale.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/scale/scale.md)
+- [Scrollbar.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/scrollbar/scrollbar.md)
+- [Spinbox.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/spinbox/spinbox.md)
+- [Text.](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/text/text.md)

ventana.png

@@ -0,0 +1,42 @@
+# Tkinter Button
+Permite agregar botones a la GUI. Estos botones pueden mostrar una imagen o texto que indiquen su función y normalmente se conectan a una función o método que es llamado cuando el botón es presionado.
+
+## Ejemplo
+
+```python
+# -*- coding: utf-8 -*-
+"""
+Ejemplo de ventana básico con botón que abre una ventana de mensaje
+
+"""
+#Importamos las librerías necesarias
+import tkinter as tk
+
+ventana = tk.Tk() #Crea la ventana principal
+ventana.geometry("200x200") #Tamaño de la ventana en pixeles
+
+def accion():
+    tk.messagebox.showinfo("Título","Mensaje") #Crea la ventana del mensaje
+    
+#Crea el botón y lo conecta con la función
+boton = tk.Button(ventana,text="Realizar acción",command=accion)
+boton.place(x=100,y=100) #Lo ubica en la ventana principal (pixeles)
+#boton.pack(side="bottom") #(Arriba, abajo, derecha, izquierda)
+#boton.grid(row=0, column=0) #(Fila y columna)
+
+ventana.mainloop()
+```
+
+El resultado es el siguiente:
+
+![ventana button](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/ventanabutton.png)
+
+Al presionar el botón se ejecuta la función `accion` que abre la siguiente ventana:
+
+![ventana mensaje](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/mensajebutton.png)
+
+Esta es una ventana predeterminada de tkinter que permite cambiar el título y el mensaje que aparece en ella.
+
+La ventana principal se crea con `tk.Tk` y se cambia su tamaño con `ventana.geometry`. Luego, se crea el botón con `tk.Button` indicando el widget que lo va a contener, en nuestro caso `ventana`. En este ejemplo se usan las opciones `text` y `command`, la primera permite mostrar texto en el botón y la segunda permite conectar el botón con alguna función o método al ser presionado. Finalmente, se agrega el botón con `boton.place`; como se observa en el archivo [readme](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/README.md), es posible agregar el widget con los métodos `pack` o `grid` que están comentados en este ejemplo.
+
+[Aquí](https://www.tutorialspoint.com/python3/tk_button.htm) para ver más opciones de Button.

ventanagrid.png

@@ -0,0 +1,57 @@
+# Tkinter Canvas
+Permite agregar espacios rectangulares para dibujar líneas, polígonos, arcos, óvalos o mostrar imágenes.
+
+## Ejemplo
+
+```python
+# -*- coding: utf-8 -*-
+"""
+Ejemplo de ventana básico con canvas para dibujar
+
+"""
+#Importamos las librerías necesarias
+import tkinter as tk
+
+ventana = tk.Tk() #Crea la ventana principal
+ventana.geometry("500x500") #Tamaño de la ventana en pixeles
+
+#Espacio para dibujar
+canvas = tk.Canvas(ventana,bd = 10,bg ="black")
+canvas.pack()
+
+def accionArc():
+    #Dibuja un arco
+    canvas.create_arc(10,10,250,250, start = 0, extent = 150, fill = "blue")
+    
+def accionLine():
+    #Dibuja una línea
+    canvas.create_line(20,20,250,250,fill = "white")
+    
+#Botones para las acciones
+botonArc = tk.Button(ventana,text="Arco",command=accionArc)
+botonArc.pack()
+
+botonLine = tk.Button(ventana,text="Línea",command=accionLine)
+botonLine.pack()
+
+ventana.mainloop()
+```
+El resultado es el siguiente:
+
+![ventana canvas](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/canvas/ventanacanvas.png)
+
+Los botones (ver [Tkinter Button](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/button.md)) `Arco` y `Línea` están conectados respectivamente con las funciones `accionArc` y `accionLine`. Al presionar el botón `Arco` resulta:
+
+![canvasarco](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/canvas/arcocanvas.png)
+
+`canvas.create_arc` dibuja un arco, se debe indicar las coordenadas y es posible indicar el ángulo inicial, el ángulo final y el color del arco.
+
+Luego se presiona el botón línea:
+
+![canvaslinea](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/canvas/lineacanvas.png)
+
+`canvas.create_line` dibuja una línea, se debe indicar las coordenas de los dos puntos y es posible indicar el color.
+
+Después de crear la ventana principal, se crea el canvas con `tk.Canvas` y se indica el widget que lo va a contener `ventana`. Además, se usaron las opciones `bd` y `bg`, la primera permite crear un borde en el canvas y la segunda permite seleccionar el color del fondo.
+
+[Aquí](https://www.tutorialspoint.com/python3/tk_canvas.htm) para ver más opciones de Canvas.

ventanapack.png

@@ -0,0 +1,57 @@
+# Tkinter Checkbutton
+Permite mostrar opciones como un botón de activación, el botón puede ir acompañado de texto o una imagen. Se usa cuando se puede seleccionar una o varias opciones a diferencia de [Tkinter Radiobutton](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/radiobutton/radiobutton.md).
+
+## Ejemplo
+
+```python
+# -*- coding: utf-8 -*-
+"""
+Ejemplo de ventana básico con checkbutton
+
+"""
+#Importamos las librerías necesarias
+import tkinter as tk
+
+ventana = tk.Tk() #Crea la ventana principal
+
+def accion():
+    v1 = variable1.get()
+    v2 = variable2.get()
+    if v1 == True and v2 == True:
+        print("1 y 2 activados")
+    elif v1 == True and v2 == False:
+        print("1 activado y 2 desactivado")
+    elif v1 == False and v2 == True:
+        print("1 desactivado y 2 activado")
+    else:
+        print("1 y 2 desactivados")
+        
+variable1 = tk.BooleanVar() #Variables que guardan el estado de los checkbutton
+variable2 = tk.BooleanVar()
+#Crea los checkbutton y los conecta con la función y la variable respectiva
+#La función se ejecuta cada que hay un cambio en el estado de los checkbutton
+C1 = tk.Checkbutton(ventana,variable=variable1,text="1",height=5,width=20,
+                    command=accion)
+C2 = tk.Checkbutton(ventana,variable=variable2,text="2",height=5,width=20,
+                    command=accion)
+C1.pack()
+C2.pack()
+
+#Se crea un botón
+#Ejecuta la función sin cambiar el estado de los checkbuton
+boton = tk.Button(ventana, command=accion, text="Verificar")
+boton.pack()
+
+ventana.mainloop()
+```
+El resultado es el siguiente:
+
+![ventana checkbutton](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/checkbutton/ventanacheckbutton.png)
+
+El botón está conectado a la función `accion` (Ver [Tkinter Button](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/button.md)), al igual que los checkbutton al cambiar de estado. La función muestra en la terminal el estado actual de los dos checkbutton como se observa a continuación:
+
+![funcion checkbutton](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/checkbutton/funcioncheckbutton.png)
+
+Después de crear la `tk.Tk` se define la función y los checkbutton. Para los checkbutton además de definir el widget que los va a contener, en este caso `ventana`, se definen las opciones `variable`, `text`, `command`, `height` y `width`. Las dos últimas definen el tamaño del chekbutton, `variable` guarda el estado actual del checkbutton `True` o `False`, `text` es el texto que acompaña el botón de activación y `command` permite llamar una función cuando cambia el estado del checkbutton.
+
+[Aquí](https://www.tutorialspoint.com/python/tk_checkbutton.htm) para ver más opciones de Checkbutton.

ventanaplace.png

@@ -0,0 +1 @@
+

widgets/button/button.md

@@ -0,0 +1,47 @@
+# Tkinter Combobox
+Permite agregar un menú desplegable a la GUI. Solo es posible seleccionar una opción de las que se encuentren en el combobox, o si está permitido, es posible agregar otra opción diferente a las que ya están.
+
+## Ejemplo
+
+```python
+# -*- coding: utf-8 -*-
+"""
+Ejemplo de ventana básico con combobox
+
+"""
+#Importamos las librerías necesarias
+import tkinter as tk
+from tkinter import ttk
+
+ventana = tk.Tk() #Crea la ventana principal
+
+#Insertar 20 elementos
+lista = []
+for i in range(20):
+    lista.append("Elemento {}".format(i))
+
+#Crear el widget combobox
+#State controla si se puede ingresar valores al combobox por teclado
+combobox = ttk.Combobox(ventana, values=lista, state="readonly")
+combobox.pack()
+
+def mostrar():
+    #Verifica si hay algún elemento seleccionado y lo muestra
+    if combobox.get() != "":
+        print(combobox.get())
+        
+#Se crea un botón y se conecta con la función
+boton = tk.Button(ventana,text="Mostrar selección",command=mostrar)
+boton.pack()
+
+ventana.mainloop()
+```
+El resultado es el siguiente:
+
+![ventana combobox](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/combobox/ventanacombobox.png)
+
+El combobox permite seleccionar alguna de las opciones, el botón está conectado a la función `mostrar` (ver [Tkinter Button](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/button.md)) que al ser ejecutada muestra en la terminal el elemento que está seleccionado en el combobox así:
+
+![funcion combobox](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/combobox/funcioncombobox.png)
+
+En este ejemplo, después de crear la ventana principal `tk.Tk`, se crea la lista con los elementos que estarán en el menú. Luego se define el combobox, indicando el widget en el que estará con las opciones `values` y `state`; la primera permite ingresar la lista de opciones que mostrará el combobox y la última es para indicar si se permite o no ingresar más opciones de las que están en `values`.

widgets/button/mensajebutton.png

@@ -0,0 +1,54 @@
+# Tkinter Entry
+Es un widget que permite agregar una sola línea de texto al usuario.
+- Si quiere permitir agregar varias líneas de texto usar el widget [Text](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/text/text.md).
+- Si quiere mostrar pero no permitir editar varias líneas de texto usar el widget [Label](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/label/label.md) o [Message](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/message/message.md).
+
+## Ejemplo
+
+```python
+# -*- coding: utf-8 -*-
+"""
+Ejemplo de ventana básico con entry
+
+"""
+#Importamos las librerías necesarias
+import tkinter as tk
+
+ventana = tk.Tk() #Crea la ventana principal
+ventana.geometry("250x100")
+
+variable1 = tk.StringVar() #Variable que guarda el texto del label
+variable1.set("Er54xsW") #Cambia el texto de la variable
+#Se crea el label y se conecta con variable1
+label = tk.Label(ventana,textvariable=variable1)
+label.pack()
+
+variable = tk.StringVar() #Variable que guarda el texto del entry
+#Se crea el entry y se conecta con variable
+entrada = tk.Entry(ventana,textvariable=variable,bd = 5,width=20)
+entrada.pack()
+
+def accion():
+    #Comprueba texto del label y del entry
+    if variable1.get() == variable.get():
+        print("Correcto")
+    else:
+        print("Incorrecto")
+
+#Crea el botón y lo conecta con la función
+boton = tk.Button(ventana,text="Verificar",command=accion)
+boton.pack()
+
+ventana.mainloop()
+```
+El resultado es el siguiente:
+
+![ventana entry](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/entry/ventanaentry.png)
+
+El botón está conectado a la función `accion` (Ver [Tkinter Button](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/button/button.md)), la cual comprueba si el texto en el label (Ver [Tkinter Label](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/label/label.md)) es igual al texto en el entry, mostrando en la terminal "correcto" o "incorrecto".
+
+![funcion entry](https://github.com/juan-suarezp/PythonTkinterTutorial/blob/master/widgets/entry/funcionentry.png)
+
+Primero se crea la `tk.Tk`, luego se define el label, el entry, la función y el botón. Para el entry se usan las opciones `textvariable`, `bd` y `width`. `textvariable` es para indicar la variable que guarda el texto que contiene el entry, `bd` crea un borde en el widget y `width` define el ancho.
+
+[Aquí](https://www.tutorialspoint.com/python3/tk_entry.htm) para ver más opciones de Entry.

widgets/button/ventanabutton.png

@@ -0,0 +1 @@
+