Lab Manuel d'utilisation
Le composant AJUI_Tip est livré avec l'application AJUI_Tip_Lab.
Cette application de productivité, fournie avec son code source sur Github, est destinée à devenir votre laboratoire créatif et de test pour la mise en œuvre du composant AJUI_Tip.
AJUI_Tip_Lab a pour but de faciliter l’intégration du composant AJUI_Tip dans votre application. Ces trois principaux avantages sont :
- Il raccourcit le temps de développement nécessaire pour définir vos Tips.
- Il permet un rendu visuel dynamique de votre Tips.
- Il offre une gestion simple et rapide de vos différents modèles qui pourront être importés dans vos applications utilisant le composant AJUI_Tip.
Le Lab vous propose une interface graphique qui expose toutes les propriétés avec un affichage dynamique du résultat.
Une fois que vous aurez obtenu la représentation graphique espérée de votre Tip, il ne vous restera plus qu'à le sauvegarder sous forme de modèle.
Le Lab vous permettra de créer autant de modèles que vous le désirez. Il est fourni avec un nombre de modèles de base assez important et couvrant un large spectre de type de Tip. Vous pourrez dupliquer ceux-ci pour les décliner et ainsi servir de base à vos propres modèles.
L’application vous met également à disposition des formulaires HDI (How Do I) vous présentant différents contextes d’utilisation de AJUI_Tip.
Un modèle représente une instance d’AJUI_Tip. Le Lab permet d’accéder aux différentes propriétés de cette instance et de modifier leurs valeurs.
Pour pouvoir manipuler ces propriétés, le Lab offre une listbox dynamique contenant les valeurs de ces propriétés. L’utilisateur peut interagir avec la listbox afin de modifier ces valeurs comme il le ferait avec la fenêtre de la liste des propriétés de l’éditeur de formulaire de 4D.
Certaines propriétés sont associées à des boutons alternatifs permettant notamment d’ouvrir la palette de couleur ou encore pour sélectionner un chemin de fichier pour les images par exemple.
Le lab est séparé en trois parties distinctes. La première partie concerne la gestion des modèles, cela concerne notamment le stockage, création, sauvegarde, suppression, etc.
La deuxième partie permet d’éditer les différentes propriétés de vos modèles.
La dernière partie est la zone d’affiche du Tip dynamique.
Les modèles de base sont stockés dans le dossier /Resources/AJUI_Tip_Templates dans le dossier de ressources de l'application Lab. Les modèles dans ce dossier sont libellés avec comme suffixe "(G)" dans le menu de sélection des modèles.
Deux autres emplacements de dossier sont à votre disposition vous permettant de stocker vos modèles : le chemin de dossier Personnel (P) et le chemin dossier Partagé (S) que vous pourrez définir à votre convenance.
Le Lab gère un fichier de préférence vous permettant de modifier les chemins à ces deux dossiers (le fichier est sauvé dans le dossier de préférence de votre ordinateur).
À chaque lancement du Lab, l’application consultera le fichier de préférence afin de récupérer les différents modèles présents dans les dossiers indiqués dans votre fichier de préférence.
Un filtre est à votre disposition, si vous désirez réduire la liste des modèles à un dossier spécifique.
Le Lab propose huit boutons vous permettant de gérer vos modèles. La fonction de chacun de ces boutons est décrite grâce un Tip qui s'affiche lors du survol de la souris sur ceux-ci.
Description de leurs fonctionnalités :
Cette fonctionnalité permet de créer un nouveau modèle. Le modèle créé est automatiquement sauvegardé dans le dossier de préférence sélectionné.
Crée une copie du modèle dans le même dossier ou celui-ci se trouve. La copie est suffixée par « _copy ». Si vous dupliquez à nouveau le même modèle d'origine sans avoir renommé la précédente copie, alors cette dernière sera écrasée par le nouveau fichier dupliqué.
Permets de renommer le modèle et de redéfinir le dossier de destination.
Permets de sauvegarder le modèle dans le dossier sélectionné. Si vous aviez choisi un modèle du dossier Global (G) et que vous le sauvegardez dans votre dossier personnel (P), le modèle dans le dossier Global n’est pas déplacé dans le dossier personnel (P) mais est dupliqué dans ce dernier.
Vous pouvez réaliser un quick save en utilisant option + clic (mac) ou alt + clic (window), cela aura pour effet de passer la confirmation et de sauvegarder le template au même emplacement.
Cette fonctionnalité supprime le modèle sélectionné.
Permets d’effacer des modifications en cours en rechargeant l’instance du modèle dans l’état où elle se trouvait lors de la dernière sauvegarde ou lors de son chargement si aucune sauvegarde n’a été faite entre temps.
Cette fonctionnalité rend inaccessibles les propriétés d’un modèle et donc permets d’éviter qu’elles soient modifiées malencontreusement.
Une bannière est affichée lorsqu’un modèle est protégé.
Cette fonctionnalité affiche sous forme de code les formules de chaque propriété présente dans la listbox avec leurs valeurs passées en paramètre. Ce code peut être copié pour être réutilisé dans vos applications si vous ne souhaitez pas passer par l’importation du modèle. Il sert également d’exemple pour la liste des formules.
La listbox du lab marque en gras, les propriétés dont la valeur actuelle est différente de la valeur par défaut. En maintenant la touche « control » et en faisant un clic gauche sur la propriété, vous pouvez réinitialiser à sa valeur par défaut.
