DEFINITION.

Créer un nouvel objet associant un éditeur de texte avec un ascenseur vertical placé à sa droite dans un cadre sans titre (tkinter.scrolledtext.ScrolledText ( ) ).

SYNTAXE.

TXT_Editeur = tkinter.scrolledtext.ScrolledText ( parent , attribut1 = valeur , ... , attributn = valeur )

TXT_Editeur = ⇨ affectation de l'instance de l'éditeur de texte [ optionnel ]

tkinter.scrolledtext.ScrolledText ( ) ⇨ création d'une instance de tkinter.scrolledtext.ScrolledText ( ) [ OBLIGATOIRE ]

parent ⇨ conteneur de l'instance de tkinter.ScrolledText ( ) [ OBLIGATOIRE ]

attribut = valeur ⇨ attribut à modifier avec sa nouvelle valeur [ optionnel ]

REMARQUES.

La classe tkinter.scrolledtext.ScrolledText ( ) n'est pas native du module tkinter, il faut donc commencer par importer le module tkinter.scrolledtext pour pouvoir utiliser cette classe. Voir import pour plus de détails sur l'incorporation de modules, classes et méthodes non built-in dans un script.

La classe tkinter.scrolledtext.ScrolledText ( ) fournit une manière rapide, sûre et élégante d'associer : 

- un éditeur de texte, créer avec la classe tkinter.Text ( ) et ;

- une, et une seule, barre de défilement vertical, créer avec la classe tkinter.Scrollbar ( ) dans ;

- un cadre sans titre, créer avec la classe tkinter.Frame ( ).

Chacun de ces composant hérite des attributs et méthode de leur classe respective. 

Pour appeler une méthode ou modifier un attribut de l'élément éditeur de texte, on procédera de la même manière que pour un éditeur de texte conventionnel. Par exemple : TXT_Editeur.insert ( "end" , "Python avec Origine NERD" ) insérera Python avec Origine NERD à la fin du contenu de l'éditeur de texte. Voir la classe tkinter.Text ( ) pour consulter les attributs et les méthodes des éditeur de texte.

Pour appeler une méthode ou modifier un attribut de l'élément barre de défilement, on utilisera la méthode tkinter.scrolledtext.ScrolledText ( ).vbar suivie du nom de la méthode ou de l'attribut souhaité. Par exemple : TXT_Editeur.vbar.identify ( 123 , 321 ) identifiera la partie de la barre de défilement au coordonnées (123,321). Voir la classe tkinter.Scrollbar ( ) pour consulter les attributs et les méthodes des éditeur de texte.

Pour modifier un attribut du conteneur, le cadre sans titre, on utilisera la méthode tkinter.scrolledtext.ScrolledText ( ).frame.config ( attribut = valeur ) ou tkinter.scrolledtext.ScrolledText ( ).frame [ "attribut" ] = valeur. Par exemple : TXT_Editeur.frame.config ( relief = "ridge" ) ou TXT_Editeur.frame [ "relief" ] = "ridge" modifiera l'aspect de la bordure du cadre sans titre. Voir la classe tkinter.Frame ( ) pour consulter les attributs et les méthodes des éditeur de texte.

Les objets permanents de type tkinter.scrolledtext.ScrolledText ( ) sont identifiés dans le site par : TXT_. 

Voir les conventions sur les variables utilisées dans ce site ...

EXEMPLE.

import tkinter

import tkinter.scrolledtext

def FNC_Ajouter ( *event ) :

TXT_Test.insert ( "end" , "\nNouvelle ligne ..." )

kposition = TXT_Test.vbar.get ( )

TXT_Test.insert ( "end" , f"\nposition de la glissière : { kposition }" )

TKI_Principal = tkinter.Tk ( )

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

TXT_Test = tkinter.scrolledtext.ScrolledText ( TKI_Principal , width = 30 , height = 10 )

BUT_Quitter.pack ( )

TXT_Test.pack ( )

ktexte = "L'interpréteur Python et sa vaste bibliothèque standard sont disponibles librement, sous forme de sources ou de binaires, pour toutes les plateformes majeures depuis le site Internet https://www.python.org/ et peuvent être librement redistribués. Ce même site distribue et pointe vers des modules, des programmes et des outils tiers. Enfin, il constitue une source de documentation... (documentation officielle de Python)."

TXT_Test.insert ( "end" , ktexte )

TXT_Test.vbar.config ( bg = "red", troughcolor = "yellow" )

TXT_Test.vbar [ "command" ] = FNC_Ajouter

TXT_Test.frame.config ( relief = "ridge" , bd = 5 )

TXT_Test.frame [ "bg" ] = "blue"

TKI_Principal.mainloop ( )