DESCRIPTION.

Retourne les caractéristiques de la surface rectangulaire contenant le paragraphe d'un éditeur de texte contenant l'index précisé.

SYNTAXE.

TPL_Valeurs = TXT_Editeur.dlineinfo ( index )

TPL_Valeurs = ⇨ variable qui recevra le tuple ( ) [ optionnel ]

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

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

index ⇨ index du caractère [ 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 ou une position particulière.Voir la méthode tkinter.Text ( ).index ( ) pour plus d'informations sur les index.

La méthode tkinter.Text ( ).dlineinfo ( ) retourne un tuple ( ) de 4 valeurs, des int ( ), exprimés en pixels et caractérisant une surface rectangulaire, ou boite englobante, contenant entièrement le paragraphe, contenu compris entre 2 retours à la ligne (\n), contenant index :

- la première valeur désigne l'abscisse du bord gauche de la boite, par rapport au bord gauche de l'éditeur de texte ;

- la deuxième valeur désigne l'ordonnée du bord haut de la boite, par rapport au bord haut de l'éditeur de texte ;

- la troisième valeur désigne la largeur de la boite englobante ;

- la quatrième valeur désigne la hauteur de la boite englobante ;

- la cinquième valeur désigne la position de la ligne de base, par rapport au bord haut de la boite englobante.

Si index désigne un paragraphe placé en dehors de la fenêtre de visibilité, c'est-à-dire non visible au moment de l'appel de la méthode, tkinter.Text ( ).dlineinfo ( ) retourne None.

La méthode tkinter.Text ( ).dlineinfo ( ) peut retourner des valeurs incorrectes 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 ( ).dlineinfo ( ).

EXEMPLE.

import tkinter

def FNC_Affichage ( ) :

LAB_Pointeur_Index [ "text" ] = f"pointeur : { TXT_Editeur.index ( 'current' ) } : "

LAB_Pointeur_Bbox [ "text" ] = TXT_Editeur.dlineinfo ( "current" )

LAB_Curseur_Index [ "text" ] = f"Curseur : { TXT_Editeur.index ( 'insert' ) } : "

LAB_Curseur_Bbox [ "text" ] = TXT_Editeur.dlineinfo ( "insert" )

TKI_Principal.after ( 100 , FNC_Affichage )

def FNC_Cesure ( *event ) :

TXT_Editeur [ "wrap" ] = TKV_Choix.get ( ) 

TKI_Principal = tkinter.Tk ( ) 

TKV_Choix = tkinter.StringVar ( )

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

RAD_Char = tkinter.Radiobutton ( TKI_Principal , text = "char" , value = "char" , variable = TKV_Choix) 

RAD_Word = tkinter.Radiobutton ( TKI_Principal , text = "word" , value = "word" , variable = TKV_Choix ) 

RAD_None = tkinter.Radiobutton ( TKI_Principal , text = "none" , value = "none" , variable = TKV_Choix ) 

LAB_Curseur_Index = tkinter.Label ( TKI_Principal )

LAB_Curseur_Bbox = tkinter.Label ( TKI_Principal )

LAB_Pointeur_Index = tkinter.Label ( TKI_Principal )

LAB_Pointeur_Bbox = tkinter.Label ( TKI_Principal )

TXT_Editeur = tkinter.Text ( TKI_Principal , font = ( None , 14 ) , width = 30 , height = 5 )

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

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

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

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

LAB_Pointeur_Index.grid ( row = 2 , column = 0 , sticky = "w" )

LAB_Pointeur_Bbox.grid ( row = 2 , column = 1 , columnspan = 2 , sticky = "w" )

LAB_Curseur_Index.grid ( row = 3 , column = 0 , sticky = "w" )

LAB_Curseur_Bbox.grid ( row = 3 , column = 1 , columnspan = 2 , sticky = "w" )

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

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

TXT_Editeur.insert ( "end + 1 line" , "\n\n" )

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

TKV_Choix.trace ( "w" , FNC_Cesure )

TKV_Choix.set ( "char" )

FNC_Affichage ( )

TKI_Principal.mainloop ( )