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.insert ( index , chaine , format )

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

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

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

chaine ⇨ nouveau contenu [ OBLIGATOIRE ]

format ⇨ formatage du nouveau contenu [ optionnel ]

TXT_Editeur.insert ( index , chaineA , formatA  , ... , ...  , chaineN , formatN )

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

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

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

chaine ⇨ nouveau contenu [ OBLIGATOIRE ]

format ⇨ formatage du nouveau contenu [ optionnel ]

REMARQUES.

index est un 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, une région, ou une position particulière.Voir la méthode tkinter.Text ( ).index ( ) pour plus d'informations sur les index.

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

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 le formatage appliqué sur les deux éléments avant et après index 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ésents dans le tuple ( ) seront appliqués à la totalité de chaine, à l'exclusion de tout autre.

Un seul appel de la méthode tkinter.Text ( ).insert ( ) 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'un seul argument index par appel mais le dernier argument format peut être omis.

Voir la méthode tkinter.Text ( ).replace ( ) pour remplacer une portion du contenu par une nouvelle suite d'éléments. 

EXEMPLE.

import tkinter , tkinter.filedialog

def FNC_Formater ( Q ) :

try :

TXT_Editeur.tag_add ( Q , "sel.first" , "sel.last" )

FNC_Description ( )

except :

pass

def FNC_Ouvrir ( Q ) :

kextentions = [ ( "texte" , ".txt" ) , ( "python" , ".py" ) ]

kfichier = tkinter.filedialog.askopenfilename ( title = "Ouvrir" , filetypes =  kextentions )

if len ( kfichier ) < 1 : return

if Q == "r" : TXT_Editeur.delete ( "1.0" , "end" )

with open ( kfichier ) as FIL_Fichier : TXT_Editeur.insert ( "insert" , FIL_Fichier.read ( ) )

TKI_Principal = tkinter.Tk ( )

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

BUT_Remplacer = tkinter.Button ( TKI_Principal , text = "Changer par un fichier" , command = lambda : FNC_Ouvrir ( "r" ) )

BUT_Inserer = tkinter.Button ( TKI_Principal , text = "Insérer un fichier" , command = lambda : FNC_Ouvrir ( "i" ) )

BUT_Bleu = tkinter.Button ( TKI_Principal , text = "Bleu" , command = lambda : FNC_Formater ( "bleu" ) )

BUT_Rouge = tkinter.Button ( TKI_Principal , text = "Rouge" , command = lambda : FNC_Formater ( "rouge" ) )

BUT_Vert = tkinter.Button ( TKI_Principal , text = "Vert" , command = lambda : FNC_Formater ( "vert" ) )

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

TXT_Editeur.grid ( row = 0 , column = 0 , columnspan = 3 , sticky = "nesw" )

BUT_Bleu.grid ( row = 1 , column = 0 , sticky = "nesw" )

BUT_Rouge.grid ( row = 1 , column = 1 , sticky = "nesw" )

BUT_Vert.grid ( row = 1 , column = 2 , sticky = "nesw" )

BUT_Remplacer.grid ( row = 2 , column = 0 , columnspan = 2 , sticky = "nesw" )

BUT_Quitter.grid ( row = 2 , column = 2 , rowspan = 2 , sticky = "nesw" )

BUT_Inserer.grid ( row = 3 , column = 0 , columnspan = 2 , sticky = "nesw" )

TXT_Editeur.tag_config ( "bleu" , foreground = "blue" , background = "aqua" )

TXT_Editeur.tag_config ( "rouge" , foreground = "red" , background = "pink" )

TXT_Editeur.tag_config ( "vert" , foreground = "green" , background = "palegreen" )

TXT_Editeur.insert ( "1.0" , "Vous pouvez tapez un text ici ...\nou tous remplacer avec\n" )

TXT_Editeur.insert ( "end" , "Changer par un fichier" , "rouge" , "\n" )

TXT_Editeur.insert ( "end" , "ou insérer un ficher\nau curseur d'insertion avec\n" )

TXT_Editeur.insert ( "end" , "Insérer un fichier\n" , ( "vert" , ) )

TXT_Editeur.insert ( "end" , "\npuis faire une sélection\net la colorée " )

TXT_Editeur.insert ( "end" , "BLEU " , ( "bleu" , ) , "ROUGE " , ( "rouge" , ) , "VERT " , ( "vert" , ) , "\n" )

TXT_Editeur.focus_force ( )

TKI_Principal.mainloop ( )