FR 1. Prise en main
AJUI_BreadCrumb doit être placé dans le dossier composant de votre application.
Dans cette partie, nous décrivons la suite d’opération à réaliser afin de générer un simple Breadcrumb dans le contexte du formulaire principal.
AJUI_Breadcrumb a besoin d’un objet de type image qui va servir de modèle. Cet objet est fourni avec la librairie AJUI_Library que vous pouvez ouvrir depuis votre application (/File/Open/Object Library...) et il vous suffira de faire glisser (Drag & Drop) l’objet « BreadCrumb_object » sur votre formulaire.
Vous pourrez dupliquer cet objet pour créer autant de Breadcrumb que nécessaire. Chaque Breadcrumb devra avoir un nom spécifique que vous pouvez définir à votre fantaisie.
Si vous créez le Breadcrumb par vous-même, n’oubliez pas d’activer les événements requis au fonctionnement du Breadcrumb (voir le chapitre sur les événements).
La première chose à faire lors de la création d’un Breadcrumb est d’ouvrir la méthode de votre objet de formulaire image et de créer une instance avec la méthode « New AJUI_BreadCrumb ». Ensuite, associer le nom de votre objet de formulaire à l’instance avec la fonction membre « Name ». Puis, ajouter des sections avec la fonction membre « AddSection ». Voilà, le Breadcrumb est créé et va utiliser les valeurs par défaut, il ne vous reste plus qu'à adapter les paramètres de celui-ci à vos besoins en termes d'interface et de fonctionnement.
Case of
: (Form event code =On Load)
Form.bc:=New AJUI_BreadCrumb ()
Form.bc.Name("myBC")
Form.bc.addSection("sect_home";New object("label";"Home"))
Form.bc.addSection("sect_products";New object("label";"Products"))
Form.bc.addSection("sect_enterprise";New object("label";"Enterprise"))
Form.bc.addSection("sect_support";New object("label";"Support"))
Form.bc.addSection("sect_store";New object("label";"Store"))
Form.bc.addSection("sect_contact";New object("label";"Contact"))
End case
Form.bc.Draw ()
Pour cela, il suffit d’appeler les fonctions membres des propriétés qui sont décrites dans les chapitres correspondants. Tester, les différentes compositions et types. Changer également les valeurs des propriétés pour différents états en utilisant les constantes voulues. Pour finir, encapsuler le tout dans un événement « on load » et lancer la fonction « Draw ».
Pour information, les valeurs par défaut font en sorte de réaliser un modèle « arrow ».
Nous avons fait le tour au niveau des bases de construction et pour la suite, nous vous conseillons grandement d'utiliser l’application « AJUI_BreadcrumbLab » qui vous est fournie sous forme de code source et qui sert de démonstrateur du composant.
AJUI_BreadcrumbLab vous met à disposition un environnement vous permettant de mieux appréhender les résultats graphiques des différentes propriétés et de créer rapidement des templates afin de vous simplifier la définition de vos Breadcrumb. Cela permet aussi de voir de façon clair quelles propriétés sont utilisables par chaque modèle. Il est livré avec un certain nombre de modèles prédéfinis.
Depuis la V18R3, vous pouvez remplacer l'instance retournée par New AJUI_BreadCrumb par l'appel de la classe Breadcrumb. Les fonctions de la classe Breadcrumb utilisent les mêmes noms et les mêmes paramètres que pour les formules obtenable par New AJUI_BreadCrumb. Les valeurs par défaut sont également les mêmes.
La seule différence en terme de code se trouvent lors de la création de l'instance :
//avec les formules
$myBC:=new AJUI_BreadCrumb ()
//avec la classe
$myBC:= AJUI_Breadcrumb.new ()