DESCRIPTION.

Compare la position d'un élément par rapport à un autre élément dans éditeur de texte.

SYNTAXE.

Variable = TXT_Editeur.compare ( pivot , comparateur , reference )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

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

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

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

comparateur ⇨ comparateur à appliquer [ OBLIGATOIRE ]

reference ⇨ index du deuxième élément [ OBLIGATOIRE ]

REMARQUES.

pivot et reference 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.

comparateur est un str ( ) pouvant avoir l'une des valeurs suivantes : "<", "<=", "==", "!=", "> ou "=>" et désignant le type de comparaison entre les deux éléments aux index pivot et reference.

Si l'expression pivot comparateur reference est vrai, alors la méthode tkinter.Text ( ).compare ( ) retourne True sinon False. Il est donc possible d'utiliser l'appel de cette méthode directement comme expression dans un bloc de tests conditionnels if - elif - else ou dans une boucle conditionnelle while.

La méthode tkinter.Text ( ).compare ( ) peut retourner une valeur incorrecte si l'affichage n'a pas été mise à jour. Il est donc conseillé d'utiliser la méthode tkinter.update ( ) ou la méthode tkinter.update_idletasks ( ) pour forcer le rafraichissement de l'affichage avant d'employer tkinter.Text ( ).compare ( ).

EXEMPLE.

import tkinter

def FNC_Affichage ( ) :

kdonnees = ( "blue" , "cyan" , "Pointeur APRES Curseur" )

if TXT_Editeur.compare ( "current" , "==" , "insert" ) :

kdonnees = ( "yellow" , "red" , "Pointeur SUR Curseur" )

elif TXT_Editeur.compare ( "current" , "<" , "insert" ) :

kdonnees = ( "green" , "palegreen" , "Pointeur AVANT Curseur" )

LAB_Curseur [ "text" ] = TXT_Editeur.index ( 'insert' )

LAB_Pointeur [ "text" ] = TXT_Editeur.index ( 'current' )

LAB_Comparer [ "fg" ] = kdonnees [ 0 ] 

LAB_Comparer [ "bg" ] = kdonnees [ 1 ] 

LAB_Comparer [ "text" ] = kdonnees [ 2 ] 

TKI_Principal.after ( 100 , FNC_Affichage )

TKI_Principal = tkinter.Tk ( )

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

LAB_Curseur = tkinter.Label ( TKI_Principal , width = 15 )

LAB_Pointeur = tkinter.Label ( TKI_Principal , width = 15 )

LAB_Comparer = tkinter.Label ( TKI_Principal )

TXT_Editeur = tkinter.Text ( TKI_Principal , wrap = "word" , width = 15 , height = 6 )

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

tkinter.Label ( TKI_Principal , text = "pointeur" ).grid ( row = 1 , column = 0 )

tkinter.Label ( TKI_Principal , text = "curseur" ).grid ( row = 1 , column = 1 )

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

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

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

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

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

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

TXT_Editeur.mark_set ( "insert" , "2.0" )

TXT_Editeur.focus_force ( )

FNC_Affichage ( )

TKI_Principal.mainloop ( )