DESCRIPTION.

Ajoute un nouvel onglet en dernière position à un conteneur à onglets ou affiche un onglet caché.

SYNTAXE.

NTB_Classeur.add ( contenu , attribut1 = valeur , ... , attributn = valeur )

NTB_Classeur = instance quelconque de tkinter.ttk.Notebook ( ) [ OBLIGATOIRE ]

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

contenu ⇨ contenu de l'onglet [ OBLIGATOIRE ]

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

REMARQUES.

contenu doit être un controle unique ou un conteneur de controles. 

Si contenu est un controle unique, et bien que cela soit vivement déconseillé, il peut être créé avec l'appel de la méthode tkinter.ttk.Notebook ( ).add ( ). Dans ce cas, il n'est pas utile d'indiquer le parent, conteneur, du controle qui est l'onglet lui-même.

Si contenu est un conteneur de controles, il est souhaitable de la créer avant de l'insérer dans l'onglet à l'aide de son identifiant . Les controles enfants du conteneur pourront être créés et placés, voire cachés ou détruits, dans le conteneur avant ou après l'insertion du conteneur dans l'onglet. Bien entendu, les enfants du conteneur, ainsi que la composition du conteneur, pourront être modifiés après l'affichage du classeur.

Si l'onglet n'existe pas, il est créé et placé en dernière position dans la liste des onglets du classeur. Si l'onglet existe et qu'il avait été caché avec la méthode tkinter.ttk.Notebook ( ).hide ( ), il est affiché à sa position dans la liste des onglets du classeur. 

Voir tkinter.ttk.Notebook ( ).insert ( ) pour créer un onglet à une position précise.

LISTE DES ATTRIBUTS DES ONGLETS. 

compound = position

Positionne de l'image par rapport au texte dans l'étiquette de l'onglet. position doit être un str ( ) représentant une position valide. Les positions valides sont : "bottom", "center", "left", "right" et "top".

image = image

Indique l'image à insérer dans l'étiquette de l'onglet à la place ou avec le texte. image doit être un objet créé avec la classe tkinter.PhotoImage ( ).

padding = marges

Définit les marges à l'intérieur de l'onglet, autour du controle enfant. marges est un tuple ( ) composé de int ( ) pouvant prendre la forme ( gauche , haut , droite , bas ), ( gauche , haut&bas , droite ), ( gauche&droite , haut&bas ), ( marges ) ou marges.

state : etat 

Modifie l'état de l'onglet. Un onglet peut avoir l'un des état suivant : "normal", "disabled" ou "hidden".

sticky = ancre

Indique la distribution de l'espace non occupé par le controle dans la cellule. ancre doit avoir l'une des valeur suivantes : "", "n", "ne", "e", "se", "s", "sw", "w", "nw", "ns", "ew", "nse", "nsw", "ewn", "ews", "nesw".

text = chaine

Texte de l'étiquette de l'onglet. chaine doit être un str ( ) quelconque mais valide. 

underline = index

Définit la position du caractère de l'étiquette qui sera souligné. index est un int ( ). Si index est négatif, aucun caractère ne sera souligné. Pour rappel, le premier caractère du texte a pour index = 0.

EXEMPLE.

import tkinter , tkinter.ttk

TKI_Principal = tkinter.Tk ( )

NTB_Classeur =  tkinter.ttk.Notebook ( TKI_Principal )

FRM_Onglet_A = tkinter.Frame ( NTB_Classeur )

tkinter.Label ( FRM_Onglet_A , text = "Fermeture de l'application" ).pack ( )

tkinter.Button ( FRM_Onglet_A , text = "Sans action" ).pack ( )

tkinter.Button ( FRM_Onglet_A , text = "Non programmé" ).pack ( )

FRM_Onglet_B = tkinter.Frame ( NTB_Classeur )

NTB_Classeur.add ( FRM_Onglet_A , text = "Un" )

NTB_Classeur.add ( FRM_Onglet_B , text = "Deux" )

NTB_Classeur.add ( tkinter.Button ( text = "Quitter" , command = TKI_Principal.destroy ) , text = "Quitter" , padding = 25 )

tkinter.Label ( FRM_Onglet_B , text = "Un autre onglet" ).pack ( )

tkinter.Entry ( FRM_Onglet_B ).pack ( )

NTB_Classeur.pack ( )

tkinter.Spinbox ( FRM_Onglet_B , values = ( "Python 2.7" , "Python 3.9" , "Java" , "JavaScript" , "C, C++, C#" ) ).pack ( )

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

TKI_Principal.mainloop ( )