DESCRIPTION.

Ouvre une boite de dialogue invitant l'utilisateur a saisir un texte.

SYNTAXE.

tkinter.simpledialog.askstring ( entete , message , attribut1 = valeur , ... , attributn = valeur )

tkinter.simpledialog.askstring ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

entete ⇨ titre de la boite de dialogue [ OBLIGATOIRE ]

message ⇨ instruction de saisie [ OBLIGATOIRE ]

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

LISTE DES ATTRIBUTS. 

initialvalue = valeur

valeur doit être un str ( ) valide. Si initialvalue est présent, valeur sera affiché dans la zone de saisie lors de l'affichage de la boite de dialogue.

maxvalue = valeur

valeur doit être un str ( ) valide qui sera la valeur maximum qui pour accepter pour valider la saisie.

minvalue = valeur

valeur doit être un str ( ) valide qui sera la valeur minimum qui pour accepter pour valider la saisie.

parent = conteneur

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 ( ).

REMARQUES.

message est un argument nommé prompt = chaine où chaine doit est un str ( ) quelconque mais valide, qui sera affiché dans la boite de dialogue, au dessus de la zone de saisie, aidant l'utilisateur dans la saisie d'une valeur adéquate. L'attribut prompt n'a pas de valeur par défaut, donc s'il est absent, Python lèvera une exception.

entete est un argument nommé title = chaine où chaine doit être un str ( ) quelconque mais valide. chaine apparaitra dans le bandeau situé en haut de la boite de dialogue. L'attribut title n'a pas de valeur par défaut, donc s'il est absent, Python lèvera une exception.

La méthode tkinter.simpledialog.askstring ( ) retourne un str ( ) avec la valeur saisie ou None si l'utilisateur a cliqué sur le bouton annuler pour fermer la boite de dialogue.

Chaque validation du choix, par le bouton valider, est testée pour s'assurer qu'il s'agit bien d'un str ( ) compris dans la plage de valeurs imposée, par les attributs minvalue et/ou maxvalue s'ils sont présents. Si l'une de ces conditions est fausse, un message invite l'utilisateur à modifier ou à annuler sa saisie.

La méthode tkinter.simpledialog.askstring ( ) n'est pas native du module tkinter, il faut donc commencer par importer le module tkinter.simpledialog 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.simpledialog. En effet le module tkinter sera automatiquement importé avec le module tkinter.simpledialog. De même il n'est pas utile de créer une instance de la classe Dialog ( ) pour appeler la méthode tkinter.simpledialog.askstring ( ).

import tkinter.simpledialog

print ( tkinter.simpledialog.askstring ( ) )

EXEMPLE.

import tkinter

import tkinter.simpledialog

def FNC_Saisir ( ) :

TKV_Reel.set ( tkinter.simpledialog.askstring ( title = "Saisie d'un texte." , prompt = "Votre texte" ) )

TKI_Principal = tkinter.Tk ( )

TKV_Reel = tkinter.StringVar ( )

tkinter.Label ( TKI_Principal , textvariable = TKV_Reel ).pack ( )

tkinter.Button ( TKI_Principal , text = "Saisir ... " , command = FNC_Saisir ).pack ( )

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

TKI_Principal.mainloop ( )