DESCRIPTION.

Retourne, déplace ou supprime la balise de l'historique d'annulation d'un éditeur de texte.

SYNTAXE.

Valeurs = TXT_Editeur.edit_modified ( etat )

Valeurs = ⇨ variable qui recevra l a valeur [ optionnel ]

TXT_Editeur ⇨ instance quelconque de tkinter.Text ( ) [ OBLIGATOIRE ]

.edit_modified ( ) ⇨ appel de la méthode [ OBLIGATOIRE ]

etat ⇨ état à donner à la balise [ optionnel ]

REMARQUES.

etat est un bool ( ). Si etat vaut True une balise, ou drapeau ou marque, est activée et placée sur le haut de la pile d'historique des modifications. Si etat vaut False la balise est désactivée et supprimée de la pile.

Si etat est absent, tkinter.Text ( ).edit_modified ( ) retourne True si la balise est activée sinon False.

A chaque nouvelle modification du contenu d'un éditeur de texte, qu'elle soit provoquée par le code du programme ou par une action de l'utilisateur, la balise est, automatiquement, activée et positionnée sur le haut de la pile d'historique des modification. L'utilité de la méthode tkinter.Text ( ).edit_modified ( ) est donc de désactiver la balise, avec la valeur False, à un moment à surveiller. Puis de vérifier la valeur de la balise : True pour active ou False pour déactivée, pour savoir si des modification ont été apportées au contenu entre les deux appels de méthode. 

Par exemple, le script peut désactiver la balise après la sauvegarde du contenu sur un support externe avec  tkinter.Text ( ).edit_modified ( False ). Puis, lors de la sortie du programme, vérifier si le contenu a été modifié avec tkinter.Text ( ).edit_modified ( ) sans argument. Si la méthode retourne True, le contenu a été modifié, le programme peut alors demander s'il doit enregistrer les modifications avant de se fermer.

EXEMPLE.

import tkinter

def FNC_Desactiver ( ) :

TXT_Editeur.edit_modified ( False )

BUT_Desactiver [ "state" ] = "disabled"

def FNC_Etat ( ) :

if TXT_Editeur.edit_modified ( ) :

BUT_Desactiver [ "state" ] = "normal"

LAB_Etat [ "text" ] = "Le texte a été modifié."

LAB_Etat [ "bg" ] = "yellow"

else :

LAB_Etat [ "text" ] = "AUCUNE MODIFICATION."

LAB_Etat [ "bg" ] = "white"

TKI_Principal.after ( 100 , FNC_Etat )

TKI_Principal = tkinter.Tk ( ) 

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

BUT_Desactiver = tkinter.Button ( TKI_Principal , text = "Désactiver la balise" , command = FNC_Desactiver )

LAB_Etat = tkinter.Label ( TKI_Principal  , relief = "solid" , bd = 3 )

TXT_Editeur = tkinter.Text ( TKI_Principal , undo = True , width = 30 , height = 5 )

TXT_Editeur.pack ( )

LAB_Etat.pack ( fill = "both" , padx = 5 , pady = 5 )

BUT_Desactiver.pack ( fill = "both" )

BUT_Quitter.pack ( fill = "both" )

TXT_Editeur.insert ( "1.0" , "Python est puissant et facile à apprendre.\n\n" )

TXT_Editeur.insert ( "end + 1 line" , "Extrait de la documentation officielle." )

TXT_Editeur.focus_force ( )

FNC_Desactiver ( )

FNC_Etat ( )

TKI_Principal.mainloop ( )