FR 2. Méthode du composant

AJUI_FloatingLabel_main

Cette méthode permet de générer un libellé flottant en se basant sur des propriétés contenues dans une variable objet devant être passée en paramètre. La méthode réagira également à quatre types d’événement 4D afin de gérer l’affichage du libellé. Nous allons revenir en détail sur ces différents éléments dans les sous-chapitres suivants.

Les propriétés

L’objet devant être passé en paramètre peut recevoir cinq propriétés.

• target (string) : correspond au nom de l’objet de formulaire cible. Par défaut, le libellé flottant utilisera l’objet de formulaire courant s'il est associé à une méthode objet de formulaire.

• activColor (string) : Couleur utilisé lorsque le libellé est actif. Par défaut, le libellé flottant prendra la couleur de l'objet formulaire FLabel_obj.

• inactivColor (string) : Couleur utilisé lorsque le libellé est inactif. Par défaut, le libellé flottant prendra le code couleur 0x00AAAAAA (gris).

• placeholder (string) : Texte affiché lorsque le libellé est actif. Par défaut, le libellé flottant prendra le texte exemple associé à la cible (se trouve dans la liste des propriétés de l’objet de formulaire).

• offset (longint) : Espace entre la cible et le libellé flottant. L’offset défini la distance entre le haut de l'objet cible et le bas du libellé flottant. L’offset est par défaut à zéro.

• Position (string) : Position du label. Doit être "top" ou "left"

• formEvent (longint) : Pour simuler un evenement. Vous devez passer une des constante 4D listée ci-dessous.

• formPath (string) : Cette propriété est utile si vous assigné une expression à votre variable formulaire via la notation à point et à la variable "Form". Vous pouvez passer un chemin d'attribut. Par exemple : "entity.firstName" ou "myValue". Cela va rechercher dans la variable "Form" si la valeur est trouvée.

• showOnEmptyField (boolean) : Permet d’afficher le label même si le contenu de la cible est un champ vide.

FLabel_obj

L’utilisation du composant nécessite la création d’un type d'objet de formulaire variable de type texte devant être nommé : FLabel_obj. Il servira de base à la création de libellés flottants par duplication. Le contenu textuel et la couleur sera définit en fonction des propriétés passées en paramètre de la méthode du composant. Vous pouvez changer le style et la police directement sur l’objet de formulaire FLabel_obj.

Les événéments

La méthode AJUI_FloatingLabel_main réagit et fait évoluer le libellé flottant en fonction de quatre types d’événement :

• On Load : prépare le libellé flottant.
• On Getting Focus : associe la couleur active.
• On Losing Focus : associe la couleur inactive.
• On after Edit : associe la couleur active uniquement si le champ n’est pas vide.

Il est donc important d’activer ces événements sur les différents champs qui vont faire appel à la méthode.