DESCRIPTION.

Ouvre une boite de dialogue, proposant à l'utilisateur de sélectionner un ou plusieurs fichiers et retourne leur chemin absolu dans un tuple ( ).

SYNTAXE.

TPL_Chemins = tkinter.filedialog.askopenfilenames ( attribut1 = valeur , ... , attributn = valeur )

TPL_Chemins = ⇨ variable qui recevra le tuple ( ) [ optionnel ]

tkinter.filedialog.askopenfilenames ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

LISTE DES ATTRIBUTS. 

filetypes = collection

collection doit être une list ( ) composé de tuple ( ) contenant deux str ( ) : le premier élément décrit le type de fichier correspondant à l'extension ; le deuxième élément est un type d'extension. collection peut contenir autant de tuple ( ) que nécessaire. Une liste déroulante proposera de choisir un type de fichier. Seuls les fichiers ayant l'extension de ce type de fichier seront présentés dans la boite de dialogue. La navigation dans les répertoire n'est pas influencée par le choix d'extension. Par défaut, si filetypes est omis, tous les fichiers non cachés du répertoire sont visibles et sélectionnables.

initialdir = chemin

chemin doit être un str ( ) correspondant au chemin d'un répertoire valide qui sera sélectionné lors de l'ouverture de la boîte de dialogue. Si chemin n'existe pas, la boite de dialogue s'ouvrira sur le répertoire dont le nom est le plus proche possible de chemin ou du répertoire par défaut au moment de l'appel. Par défaut chemin est le répertoire de travail courant.

initialfile = chemin

chemin doit être un str ( ) correspondant au chemin d'un fichier qui sera présent dans la zone de saisie lors de l'ouverture de la boîte de dialogue. Si chemin n'existe pas il sera quand même affiché dans la zone de saisie. Si initialfile est absent aucun nom de fichier ne sera affiché dans la zone de saisie.

multiple = booleen

Si multiple = True l'utilisateur peut sélectionner plusieurs fichiers. Si multiple = False, valeur par défaut, L'utilisateur ne pourra sélectionner qu'un seul fichierà la fois. A noter que si plusieurs fichiers sont sélectionnés quand l'utilisateur validera son choix, Python lèvera une exception.

parent = contenant

Identification du contenant au dessus duquel sera affiché la boîte de dialogue, par défaut c'est la fenêtre principale créée avec la classe tkinter.Tk ( ).

title = chaine

chaine doit être un str ( ) quelconque mais valide. chaine apparaitra dans le bandeau situé en haut de la boite de dialogue. Par défaut chaine vaut "Ouvrir". Attention, la valeur de l'attribut title d'une fenêtre n'est pas son nom, ni son identifiant. On ne peut pas appeler la boite de dialogue en utilisant la valeur de l'attribut title pour l'identifier.

REMARQUES.

La méthode tkinter.filedialog.askopenfilenames ( ) retourne un tuple ( ) où chaque élément donne le chemin absolu d'un des fichiers sélectionnés. Les chemins sont placé dans le même ordre que celui du répertoire ou se trouve le fichier, même si l'ordre de sélection à été différent. Si l'utilisateur clique sur le bouton "annuler" de la boîte de sélection retourne une chaine vide : "".

Les chemins retournés par la méthode tkinter.filedialog.askopenfilenames ( ) pourront ensuite être utilisés : pour insérer des images dans les controles de tkinter ; avec le module os, par exemple pour les renommer, les supprimer, les copier par blocs ... ; avec la méthode open ( ) pour consulter et:ou modifier leur contenu. Voir la méthode open ( ) pour plus de détails sur la lecture des enregistrements présents dans un fichier.

Le format des chemins retournés, en particulier l'indication du lecteur et la séparation entre les noms des sous répertoires, varie fortement en fonction de l'environnement et du système d'exploitation sur lequel tourne l'application. Dans certains cas extrêmes mais rares, la méthode peut provoquer des comportements inattendus.

La méthode tkinter.filedialog.askopenfilenames ( ) n'est pas native du module tkinter, il faut donc commencer par importer le module tkinter.filedialog pour pouvoir utiliser cette méthode. Voir import pour plus de détails sur l'incorporation de modules, classes et méthodes non built-in dans un script.

Bien que cela soit fortement déconseiller, il n'est pas nécessaire d'importer le module le module tkinter avant le module tkinter.filedialog. En effet le module tkinter sera automatiquement importé avec le module tkinter.filedialog. De même il n'est pas utile de créer une instance de la classe Load ( ) pour appeler la méthode tkinter.filedialog.askopenfilenames ( ).

import tkinter.filedialog

print ( tkinter.filedialog.askopenfilenames ( ) )

EXEMPLE.

import tkinter

import tkinter.filedialog

def FNC_Selection ( ) :

kfichiers = tkinter.filedialog.askopenfilenames ( ) 

if kfichiers == "" : return

TXT_Editeur.delete ( "1.0" , "end" )

TXT_Editeur.insert ( "end" , "Vous avez sélectionné les fichiers :\n\n" )

for kfichier in kfichiers : TXT_Editeur.insert ( "end" , f"{ kfichier }\n" )

TXT_Editeur.insert ( "end" , f"\nsoit un total de { len ( kfichiers ) } fichiers." )

TKI_Principal = tkinter.Tk ( )

BUT_Quitter = tkinter.Button ( TKI_Principal , text = "Quitter" , command = TKI_Principal.destroy )

BUT_Ouvrir = tkinter.Button ( TKI_Principal , text = "Sélectionner ... " , command = FNC_Selection )

TXT_Editeur = tkinter.Text ( TKI_Principal , wrap = "none" , width = 60 , height = 10 )

TXT_Editeur.grid ( row = 0 , column = 0 , columnspan = 2 )

BUT_Ouvrir.grid ( row = 1 , column = 0 , sticky = "w" )

BUT_Quitter.grid ( row = 1 , column = 1 ,  sticky = "e" )

TKI_Principal.mainloop ( )