DESCRIPTION.

Retourne le nombre d'éléments entre 2 index d'un éditeur de texte.

SYNTAXE.

Variable = TXT_Editeur.count ( debut , fin , unite )

Variable = ⇨ variable qui recevra la valeur [ optionnel ]

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

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

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

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

unite ⇨ type des entités à compter [ 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.

Si fin est situé avant debut, l'appel de la méthode tkinter.Text ( ).count ( ) retourne une valeur négative. Si debut et fin sont confondus, c'est-à-dire s'ils font référence au même index, tkinter.Text ( ).count ( ) retourne None.

unite est un des str ( ) désignant la nature des entités à compter entre les index debut et fin. unite peut prendre l'une des valeur suivante : 

- "chars", valeur par défaut, pour compter les caractères ;

- "displaychars", pour compter les caractères affichables ;

- "displayindices", pour compter les éléments affichables (caractères, images et fenêtres d'insertion) ;

- "displaylines", pour compter les paragraphes affichables ;

- "indices", pour compter les éléments (caractères, images et fenêtres d'insertion) ;

- "lines", pour compter les paragraphes ;

- "xpixels", pour compter les pixels horizontaux, en largeur ;

- "ypixels", pour compter les pixels verticaux, en hauteur.

EXEMPLE.

import tkinter

def FNC_Compteur ( ) :

try :

kmessage = "La sélection comprend :\n"

kmessage += f'{ TXT_Editeur.count ( "sel.first" , "sel.last" ) } caractères,\n'

kmessage += "Elle occupe :\n"

kmessage += f'{ TXT_Editeur.count ( "sel.first" , "sel.last" , "xpixels"  ) } pixels en largeur et,\n'

kmessage += f'{ TXT_Editeur.count ( "sel.first" , "sel.last" , "ypixels"  ) } pixels en hauteur.'

except :

kmessage = "Il n'y a pas de sélection !"

LAB_Compteur [ "text" ] = kmessage

TKI_Principal = tkinter.Tk ( )

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

BUT_Compter = tkinter.Button ( TKI_Principal , text = "Analyser la sélection" , command = FNC_Compteur)

LAB_Compteur = tkinter.Label ( TKI_Principal , relief = "ridge" , justify = "left" , anchor = "w" , height = 7 )

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

TXT_Editeur.pack ( )

BUT_Compter.pack ( fill = "both" )

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

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.\n" )

TXT_Editeur.focus_force ( )

TKI_Principal.mainloop ( )