FR 5. Méthodes du composant

New AJUI_Button ( { template_obj} ) -> button_obj

Cette méthode retourne une variable objet qui représente une instance d’AJUI Button. Elle contient l’ensemble des propriétés et leurs valeurs par défaut ainsi que les formules (fonctions membres) pour les manipuler. Il est possible de lui passer en paramètre un objet afin d’importer un template d’AJUI Button (fichier JSON). L’objet attend comme propriétés :

• templateName : Corresponds au nom du dossier contenant le fichier JSON à importer (template). Si le fichier n’est pas trouvé, la méthode retournera une nouvelle instance d’AJUI Button.

C_OBJECT($o)
$o:=New object("templateName";"slideOn")
Form.btn1:=New AJUI_Button ($o)
Form.btn1.Name("btn1")

• templatePath (optionnel) : Vous pouvez préciser un chemin pour récupérer le fichier sinon, le composant cherchera dans le dossier par défaut se trouvant dans les ressources de la base hôte (…/Ressources/AJUI_Button_Templates/). Vous pouvez utiliser "#" pour désigner le dossier de ressources de 4D dans votre chemin.

$template_obj:=New object("templateName";"MyTemplate.json";"templatePath";"C/:/MyTemplates/")
$myBtn:=New AJUI_Button($template_obj)

AJUI_Button ( { template_obj} ) -> class obj

Cette méthode remplace New AJUI_Button à partir de la V18R3, elle permet de retourner la classe Button. Les fonctions de la classe sont identiques aux formules. Il est possible de lui passer en paramètre un objet afin d’importer un template d’AJUI Button (fichier JSON). L’objet attend comme propriétés :

• templateName : Corresponds au nom du dossier contenant le fichier JSON à importer (template). Si le fichier n’est pas trouvé, la méthode retournera une nouvelle instance d’AJUI Button.

C_OBJECT($o)
$o:=New object("templateName";"slideOn")
Form.btn1:=AJUI_Button.new ($o)
Form.btn1.Name("btn1")

• templatePath (optionnel) : Vous pouvez préciser un chemin pour récupérer le fichier sinon, le composant cherchera dans le dossier par défaut se trouvant dans les ressources de la base hôte (…/Ressources/AJUI_Button_Templates/). Vous pouvez utiliser "#" pour désigner le dossier de ressources de 4D dans votre chemin.

$template_obj:=New object("templateName";"MyTemplate.json";"templatePath";"C/:/MyTemplates/")
$myBtn:=AJUI_Button.new ($template_obj)

AJUI_Btn_LoadTemplates ({folderPath}) -> templates_name_col

Méthode utilitaire permettant de récupérer l’ensemble des fichiers JSON d’un dossier dans une collection. Vous pouvez passer en paramètre le chemin du dossier contenant les templates. Si ce n’est pas le cas, la méthode cherchera dans chemin par défaut (…/Ressources/AJUI_Button_Templates/).

$folder:=Folder(Form.templateLocPref.path_global;fk platform path)
If($folder.exists)
  $templates_col:=AJUI_Btn_LoadTemplates($folder.platformPath)
End if

AJUI_Btn_info ( ) -> version_txt

Cette méthode retourne une chaîne de caractère représentant le numéro de version du composant.