DESCRIPTION.

Créer un nouveau controle de type sélecteur rotatif ou boite à choix (widget : tkinter.Spinbox ( )).

SYNTAXE.

SPI_Choix = tkinter.Spinbox ( parent , attribut1 = valeur , ... , attributn = valeur )

SPI_Choix = ⇨ affectation de l'instance du controle [ optionnel ]

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

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

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

CREATION DES BOITES A CHOIX.

Voir le tutoriel sur les boites à choix ...

LISTE DES ATTRIBUTS DES BOITES A CHOIX.

activebackground : couleur de fond lorsque le pointeur est sur le controle.

background ou bg : couleur du fond du controle.

borderwidth ou bd : épaisseur de la bordure du controle.

buttonbackground : couleur de fond des flèches du controle.

buttoncursor : aspect du pointeur lorsqu'il est sur une flèche du controle.

buttondownrelief : style de relief des flèches du controle actionnées. 

buttonup : style de relief des flèches du controle relachées.

command : action à effectuer lorsque l'utilisateur clique sur le controle.

cursor : définit l'aspect du pointeur selon sa position.

disabledbackground : couleur du fond lorsque le controle est désactivé.

disabledforeground : couleur de premier plan lorsque le controle est désactivé.

exportselection : autorise la copie de la sélection dans le presse-papiers.

font : police de caractères du texte du controle.

foreground ou fg : couleur du texte du controle.

format : mise en forme des valeurs numériques dans le controle.

from_ : première valeur d'un intervalle numérique.

highlightbackground : couleur de la surbrillance quand le controle n'a pas le focus.

highlightcolor : couleur de la surbrillance quand le controle a le focus.

highlightthickness : épaisseur de la surbrillance quand le controle a le focus.

increment : pas entre deux valeurs numérique dans le controle.

insertbackground : couleur curseur d'insertion d'insertion.

insertborderwidth : épaisseur du curseur d'insertion.

insertofftime : définit la durée d'effacement du curseur d'insertion.

invalidcommand ou invcmd : fonction à exécuter si la saisie est invalidée.

justify : alignement d'un texte dans le controle.

readonlybackground : couleur du fond quand le controle est en lecture seulement.

relief : aspect du controle.

repeatdelay : nombre de millisecondes avant de faire réagir le controle.

repeatinterval : nombre de millisecondes avant de re-déclencher le controle.

selectbackground : couleur de fond des caractères sélectionnés.

selectborderwidth : épaisseur de la bordure de la sélection de caractères.

selectforeground : couleur de premier plan des caractères sélectionnés.

state : détermine l'état du controle.

takefocus : indique si le controle doit réagir à la touche tabulation.

textvariable : indique la variable associée au texte du controle.

to : dernière valeur d'un intervalle numérique.

validate : événement à surveiller pour la validation d'une saisie.

validatecommand ou vcmd : indique la fonction à exécuter pour valider une saisie.

values : liste des valeurs alphanumériques proposées dans le controle. 

width : largeur du controle.

wrap : définit si les valeurs s'affiche en boucle dans une boite de sélection (tkinter.Spinbox ( )).

xscrollcommand : positionnement précis de l'ascenseur horizontal.

MÉTHODES SPÉCIFIQUES DES BOITES A CHOIX.

bbox ( ) : retourne les caractéristiques de la boite englobante d'un caractère dans le controle.

delete ( ) : supprime une partie du texte compris entre deux index.

get ( ) : retourne le contenu de la boite à choix.

icursor ( ) : déplace le curseur d'insertion dans le contenu.

identify ( ) : retourne la partie de la boite à choix aux coordonnées indiquées.

index ( ) : retourne la valeur numérique d'un index spécifique.

insert ( ) : insert le texte précisé dans le contenu du controle.

invoke ( ) : simule une des flèches de la boite à choix.

scan_dragto ( ) : fait défiler du contenu du controle.

scan_mark ( ) : mémorise un point de référence du contenu du conrole.

selection_adjust ( ) : ajuste la sélection jusqu'à l'index indiqué.

selection_clear ( ) : annule la sélection.

selection_from ( ) : débute la sélection à l'index indiqué.

selection_present ( ) : test s'il y a une sélection dans le controle.

selection_range ( ) : sélectionne une partie du contenu.

selection_to ( ) : termine la sélection à l'index indiqué.

xview ( ) : retourne la portion du contenu visible.

xview_moveto ( ) : définit le début de la portion du contenu visible.

xview_scroll ( ) : fait défiler le contenu du champs de saisie.

VERSION REVISEE DES BOITES A CHOIX TTK. 

Le module d'extension tkinter.ttk propose une version révisée de l'échelle de valeurs. L'aspect des objets de la classe tkinter.ttk.Spinbox ( ) est confié à l'attribut style. De ce fait seuls les attributs qui personnalisent réellement une boite à choix restent disponibles. Pour plus de détails, voir :

- les boutons cliquables révisés tkinter.ttk.Spinbox ( ) ;

- le module d'extension tkinter.ttk ;

- la classe tkinter.ttk.Style ( ).