FR 3. États d'un bouton

Un AJUI_Button peut prendre une apparence et un contenu différent en fonction de cinq états et des exceptions qui leur seront définis.

États

L’état « Default »

C’est l’état basique d’un bouton lorsqu’un utilisateur n’interagit pas avec lui ou que celui-ci n’est pas désactivé.

L’état « Hover »

Cet état intervient lorsque l’événement « On Mouse Enter » se déclenche et se termine sur l’événement « On Mouse Leave ». Concrètement, l’utilisateur est en train de survoler le bouton avec la souris.

L’état « Active »

Cet état intervient sur l’événement « On Click » et se termine sur l’événement « On Mouse Up. À noter qu’il a la priorité sur l’état « Hover ». Concrètement, l’utilisateur clique sur le bouton et l’état dure jusqu’au relâchement de celui-ci.

L’état « Disable »

Cet état prend place lorsqu’on désactive le bouton à l’aide de la fonction membre « Enable » de l’objet. Lorsque le bouton est désactivé, seul cet état est pris en compte.

L’état « Focus »

Cet état intervient sur l’événement « On Getting Focus » et se termine sur l’événement « On Losing Focus ».

Les événements et callbacks

Comme vous avez pu le constater par rapport aux états, le composant nécessite que plusieurs événements soit activés sur l’objet de formulaire image afin de pouvoir gérer les différents états. Voici la liste de ceux-ci :

• On Load
• On Click
• On Double Click (optionnel)
• On Mouse Enter
• On Mouse Leave
• On Mouse Up
• On Getting Focus
• On Losing Focus

Concernant les deux événements sur les clics, on peut leur associer des callbacks à l’aide des fonctions membres. De base, l’événement sur le double clic n’est pas nécessaire sauf si vous utiliser le callback.

⚠️ Toutes méthodes utilisées comme callback doivent être partagées (propriétés de la méthode) avec le composant pour que celui-ci puisse l'appeler. Pour éviter qu’une erreur se produise pour ce genre de cas, le composant vérifiera si la méthode est bien partagée et si ce n’est pas le cas, il la partagera de lui-même lors de l’exécution d’un callback. De plus, le composant proposera de créer la méthode de callback si elle n’existe pas lors de l’utilisation des Setters pour les callbacks et également avant l’exécution d’un callback.

La notion d’exception et les constantes du composant

Afin de pouvoir modifier la structure et le contenu d’un bouton, nous avons mis en place un mécanisme d’exception dans le composant qui s’appliquera sur tous les états hormis « Default » qui lui conserve toutes les propriétés de base.

Pour cela, la majorité des fonctions membres (voir la liste des propriétés pour les détails) attendent en premier paramètre une constante. Chaque constante représente l’un des cinq états. Voici la liste :

• AJUI_btn_default (pas d’exception créée)
• AJUI_btn_hover
• AJUI_btn_active
• AJUI_btn_disable
• AJUI_btn_focus

En fonction de la constante que vous allez passer à une fonction membre, celle-ci va créer une exception dans votre instance d’AJUI Button qui prendra la place de la valeur courante (Default) lorsque l’état qui lui est lié est déclenché.

Exemple d'affectation d'une couleur au texte du bouton pour chaque état :

$Mybtn.FontColor(AJUI_btn_default;"lightblue")
$Mybtn.FontColor(AJUI_btn_hover;"blue")
$Mybtn.FontColor(AJUI_btn_active;"darkblue")
$Mybtn.FontColor(AJUI_btn_disable;"grey")
$Mybtn.FontColor(AJUI_btn_focus;"red")