DESCRIPTION.

Ouvre une boite de dialogue, proposant à l'utilisateur de renouveller ou d'annuler une commande après une erreur détectée lors d'une tentative précédente.

SYNTAXE.

Choix = tkinter.messagebox.askretrycancel ( attribut1 = valeur , ... , attributn = valeur )

Choix = ⇨ variable qui recevra le chemin du répertoire [ optionnel ]

tkinter.messageboxv.askretrycancel ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

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

LISTE DES ATTRIBUTS. 

default = bouton

Modifie le bouton par défaut de la boite de dialogue. Le bouton par défaut est celui qui sera sélectionné si l'utilisateur appuie sur la touche entrée du clavier pour valider son choix. bouton doit être un str ( ) qui prendre l'une des valeurs suivantes : 

- "retry", valeur par défaut, le bouton [ Ré-essayer ] devient le choix par défaut ;

- "cancel", le bouton [ Annuler ] devient le choix par défaut.

icon = graphe

Modifie l'icone associée au texte dans de la boite de dialogue. La représentation de l'icone peut varier en fonction de l'environnement de l'utilisateur.  graphe doit être un str ( ) qui peut être :  "error", "info", "question", "warning". Par défaut graphe vaut "question".

message = chaine

chaine est un str ( ) quelconque mais valide qui sera affiché dans la zone du message de la boite de dialogue. Si message est absent, la boite de dialogue ne présentera aucun texte.

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

title = chaine

chaine doit être un str ( ) quelconque mais valide. chaine apparaitra dans le bandeau situé en haut de la boite de dialogue. . Si title est absent, la boite de dialogue n'aura aucun titre.

REMARQUES.

La méthode tkinter.messagebox.askretrycancel ( ) retourne un bool ( ) qui vaudra : 

- True, ou 1, si l'utilisateur à choisi le bouton [ Valider ] ;

- False, ou 0, si l'utilisateur à choisi le bouton [ Annuler ].

La méthode tkinter.messagebox.askretrycancel ( ) retournant un bool ( ) elle pourra être employé directement dans un test conditionnel tel que if tkinter.messagebox.askretrycancel ( ) :.

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

import tkinter.messagebox

print ( tkinter.messagebox.askretrycancel ( ) )

EXEMPLE.

import tkinter

import tkinter.messagebox

def FNC_Saisir ( ) :

ksaisie = tkinter.messagebox.askretrycancel ( title = "Oups " , message = "Anomalie constatée ..." )

ktexte = "Nouvel essai ..." if ksaisie else "Opération annulée."

TKV_Choix.set ( ktexte )

TKI_Principal = tkinter.Tk ( )

TKV_Choix = tkinter.StringVar ( )

tkinter.Label ( TKI_Principal , textvariable = TKV_Choix , width = 25 ).pack ( )

tkinter.Button ( TKI_Principal , text = "Tester  : .askretrycancel ( ) ..." , command = FNC_Saisir ).pack ( )

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

TKV_Choix.set ( "En attente ..." )

TKI_Principal.mainloop ( )