Diálogos tkinter

tkinter.simpledialog — Standard Tkinter input dialogs

Código fuente: Lib/tkinter/simpledialog.py

The tkinter.simpledialog module contains convenience classes and functions for creating simple modal dialogs to get a value from the user.

tkinter.simpledialog.askfloat(title, prompt, **kw)
tkinter.simpledialog.askinteger(title, prompt, **kw)
tkinter.simpledialog.askstring(title, prompt, **kw)

Las tres funciones anteriores proporcionan diálogos que piden al usuario que introduzca un valor del tipo deseado.

class tkinter.simpledialog.Dialog(parent, title=None)

La clase base para los diálogos personalizados.

body(master)

Sobrescribir para construir la interfaz del dialogo y retornar el widget que debe tener el foco inicial.

buttonbox()

El comportamiento por defecto añade los botones OK y Cancelar. Sobrescribir para diseños de botones personalizados.

tkinter.filedialog — File selection dialogs

Código fuente: Lib/tkinter/filedialog.py

The tkinter.filedialog module provides classes and factory functions for creating file/directory selection windows.

Diálogos nativos de carga/guardado

Las siguientes clases y funciones proporcionan ventanas de diálogo de archivos que combinan un aspecto nativo con opciones de configuración para personalizar el comportamiento. Los siguientes argumentos son aplicables a las clases y funciones enumeradas a continuación:

parent - la ventana sobre la que se situará el diálogo
title - el título de la ventana
initialdir - el directorio en el que inicia el diálogo
initialfile - el archivo seleccionado al abrir el diálogo
filetypes - una secuencia de tuplas (label, pattern), se permite el comodín “*”
defaultextension - extensión por defecto para añadir al archivo (diálogos de guardado)
multiple - cuando es verdadero, se permite la selección de múltiples elementos

Funciones estáticas de factoría

Las siguientes funciones, al ser invocadas, crean un diálogo modal de aspecto nativo, esperan la selección del usuario y retornan el(los) valor(es) seleccionado(s) o Ninguno a la llamada.

tkinter.filedialog.askopenfile(mode='r', **options)
tkinter.filedialog.askopenfiles(mode='r', **options)

Las dos funciones anteriores crean un diálogo Open y retornan el( los) objeto(s) de archivo(s) abierto(s) en modo de sólo lectura.

tkinter.filedialog.asksaveasfile(mode='w', **options)

Crea un diálogo SaveAs y retorna un objeto de un archivo abierto en modo de sólo escritura.

tkinter.filedialog.askopenfilename(**options)
tkinter.filedialog.askopenfilenames(**options)

Las dos funciones anteriores crean un diálogo Open y retornan el( los) nombre(s) de archivo(s) seleccionado(s) que corresponde(n) a un(os) archivo(s) existente(s).

tkinter.filedialog.asksaveasfilename(**options)

Crea un diálogo SaveAs y retorna el nombre del archivo seleccionado.

tkinter.filedialog.askdirectory(**options)
Pide al usuario que seleccione un directorio.
Argumento opcional adicional:
mustexist - determina si la selección debe ser un directorio existente.
class tkinter.filedialog.Open(master=None, **options)
class tkinter.filedialog.SaveAs(master=None, **options)

Las dos clases anteriores proporcionan ventanas de diálogo nativas para guardar y cargar archivos.

Clases de conveniencia

Las siguientes clases se utilizan para crear ventanas de archivos/directorios desde cero. Estas no emulan el aspecto nativo de la plataforma.

class tkinter.filedialog.Directory(master=None, **options)

Crear un diálogo que solicite al usuario que seleccione un directorio.

Nota

La clase FileDialog debe ser subclasificada para el manejo de eventos y comportamiento personalizados.

class tkinter.filedialog.FileDialog(master, title=None)

Crear un diálogo básico de selección de archivos.

cancel_command(event=None)

Activa la terminación de la ventana de diálogo.

dirs_double_event(event)

Manejador de eventos para el evento de doble clic sobre un directorio.

dirs_select_event(event)

Manejador de eventos para el evento de clic sobre un directorio.

files_double_event(event)

Manejador de eventos para el evento de doble clic sobre un archivo.

files_select_event(event)

Manejador de eventos para el evento de un solo clic sobre un archivo.

filter_command(event=None)

Filtra los archivos por directorio.

get_filter()

Recupera el filtro de archivos que se está utilizando actualmente.

get_selection()

Recupera el elemento seleccionado actualmente.

go(dir_or_file=os.curdir, pattern='*', default='', key=None)

Renderiza el diálogo e inicia el bucle de eventos.

ok_event(event)

Salir del diálogo retornando la selección actual.

quit(how=None)

Salir del diálogo retornando el nombre del archivo, si lo hay.

set_filter(dir, pat)

Establece el filtro de archivos.

set_selection(file)

Actualiza la selección de archivos actual a archivo.

class tkinter.filedialog.LoadFileDialog(master, title=None)

Una subclase de FileDialog que crea una ventana de diálogo para seleccionar un archivo existente.

ok_command()

Comprueba que se proporciona un archivo y que la selección indica un archivo ya existente.

class tkinter.filedialog.SaveFileDialog(master, title=None)

Una subclase de FileDialog que crea una ventana de diálogo para seleccionar un archivo de destino.

ok_command()

Comprueba si la selección apunta a un archivo válido que no es un directorio. Se requiere confirmación si se selecciona un archivo ya existente.

tkinter.commondialog — Dialog window templates

Código fuente: Lib/tkinter/commondialog.py

The tkinter.commondialog module provides the Dialog class that is the base class for dialogs defined in other supporting modules.

class tkinter.commondialog.Dialog(master=None, **options)
show(**options)

Renderiza la ventana de diálogo.

Ver también

Módulos tkinter.messagebox, Leyendo y escribiendo archivos