DESCRIPTION.

Insère la suite de caractères donnée dans un éditeur de texte à la position indiquée avec ou sans formatage spécifié.

SYNTAXE.

TXT_Editeur.replace ( debut , fin , chaine , format )

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

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

debut ⇨ index du premier élément [ OBLIGATOIRE ]

fin ⇨ index du dernier élément [ OBLIGATOIRE ]

chaine ⇨ nouveau contenu [ OBLIGATOIRE ]

format ⇨ formatage du nouveau contenu [ optionnel ]

TXT_Editeur.replace ( debut , fin , chaineA , formatA  , ... , ...  , chaineN , formatN )

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

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

debut ⇨ index du premier élément [ OBLIGATOIRE ]

fin ⇨ index du dernier élément [ OBLIGATOIRE ]

chaine ⇨ nouveau contenu [ OBLIGATOIRE ]

format ⇨ formatage du nouveau contenu [ optionnel ]

REMARQUES.

debut et fin sont des str ( ) quelconque mais valide désignant un index dans un éditeur de texte. Un index valide a la forme : "paragraphe.place" ou un nom correspondant à une balise ou une position particulière.Voir la méthode tkinter.Text ( ).index ( ) pour plus d'informations sur les index. 

La valeur d'index de debut doit toujours précéder celle de fin, sinon Python lèvera une exception.

chaine est un str ( ) quelconque qui peut être une variable ou exprimé directement, dans ce cas la chaine de caractère doit être valide pour Python : entouré d'une paire, ou d'un triplet, de guillemets (") ou d'apostrophes (') elle-même pouvant être préfixée d'un f ou de r. chaine sera entièrement insérée juste avant l'élément correspondant à la position index. Si index est confondu avec la fin du contenu de l'éditeur, c'est-à-dire si index équivaut à "end", chaine débutera après le dernier élément présent dans le controle, mais avant le dernier saut de ligne (\n).

chaine peut avoir une longueur différente de celle comprise entre debut et fin.

format peut être un str ( ) ou un tuple ( ) contenant un ou plusieurs str ( ) correspondant à des noms valides de formatages. Il est recommandé d'utiliser un tuple ( ) pour format même pour indiquer un formatage unique. Voir la méthode tkinter.Text ( ).tag_config ( ) pour plus détails sur les formatages. Si format est absent, chaine recevra les formatages appliqués sur les deux éléments aux index debut et fin avant l'insertion de chaine. Si un formatage n'est pas présent sur ces deux éléments, il sera ignoré. Si format est précisé, seuls les formatages présente dans le tuple ( ) seront appliqués à la totalité de chaine, à l'exclusion de tout autre.

Un seul appel de la méthode tkinter.Text ( ).replace ( ) peut contenir plusieurs paires chaine , format les unes à la suite des autres, dans ce cas format s'applique à chaine qui le précède. Quelque soit le nombre de paires chaine , format. Il ne peut y avoir qu'une seule portion de contenu debut , fin par appel mais le dernier argument format peut être omis.

Voir la méthode tkinter.Text ( ).insert ( ) pour ajouter une nouvelle suite d'éléments en l'insérant à une position précise. 

EXEMPLE.

import tkinter

def FNC_Remplacer ( ) :

if len ( ENT_Texte.get ( ) ) < 1 :

LAB_Infos [ "text" ] = "Tapez un texte dans le champ ⇩⇩⇩"

ENT_Texte.focus_force ( )

return

try :

TXT_Editeur.replace ( "sel.first" , "sel.last" , ENT_Texte.get ( ) )

ENT_Texte.delete ( 0 , "end" )

LAB_Infos [ "text" ] = "Prêt pour un nouveau test." 

except :

LAB_Infos [ "text" ] = "⇧⇧⇧ Faites une sélection dans l'éditeur"

TXT_Editeur.focus_force ( )

TKI_Principal = tkinter.Tk ( )

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

BUT_Remplacer = tkinter.Button ( TKI_Principal , text = "Remplacer la sélection" , command = FNC_Remplacer )

ENT_Texte = tkinter.Entry ( TKI_Principal )

LAB_Infos = tkinter.Label ( TKI_Principal )

TXT_Editeur = tkinter.Text ( TKI_Principal , width = 40 , height = 12 )

TXT_Editeur.pack ( )

LAB_Infos.pack ( fill = "both" )

ENT_Texte.pack ( fill = "both" )

BUT_Remplacer.pack ( fill = "both" )

BUT_Quitter.pack ( fill = "both" )

TXT_Editeur.insert ( "1.0" , "Vous pouvez tapez un texte ici ...\n" )

TXT_Editeur.insert ( "end" , "ou faire une sélection et la remplacer\n" )

TXT_Editeur.insert ( "end" , "par le texte du champ de saisie\n" )

FNC_Remplacer ( )

ENT_Texte.focus_force ( )

TKI_Principal.mainloop ( )