FR 1. Prise en main

AJUI Banner est un composant relativement simple à prendre en main.

Pour cela, nous allons vous présenter succinctement trois extraits de code vous permettant la création de bannières.

Dans tous les cas, il vous faut ajouter un objet formulaire qui contiendra la bannière et qui devra remplir les conditions suivantes :

• Cet un formulaire objet associé à une variable de type image.
• Il doit obligatoirement s’appeler AJUI_Banner sur la première page de votre formulaire.
• S’il est sur une autre page du formulaire, ajouter le numéro de page au nom de celui-ci (exemple AJUI_Banner2 pour la page 2, AJUI_Banner3 pour la page 3, etc.).
• Généralement l’objet formulaire est placé au premier plan sauf cas spécifique en fonction de vos besoins.

La gestion de la visibilité de l’image n’est pas pris en charge par le composant. Nous vous conseillons de définir dans les propriétés l’objet formulaire à invisible par défaut et de le rendre visible quand cela est nécessaire. Nous vous recommandons également d’éviter d’utiliser l’objet en page zéro (même s'il est possible de le faire) car les objets formulaires des autres pages s'afficheront en juxtaposition, au dessus.

Cas 1 : Bannière « Window » avec texte

Form.banner:=New AJUI_Banner
Form.banner.Banner("window")
Form.banner.isPicture(False)
Form.banner.Message("You're welcome")
Form.banner.DrawBanner()

Cas 2 : Bannière « Window » avec image

Form.banner:=New AJUI_Banner
Form.banner.Banner("window")
Form.banner.isPicture(True)
Form.banner.PicturePath("Images"+Folder separator+"yourPicture.png")
Form.banner.DrawBanner()

Cas 3 : Bannière « cornerRibbon » positionnée en bas à droite

Form.banner:=New AJUI_Banner
Form.banner.Banner("cornerRibbon")
Form.banner.Message("Corner Ribbon")
Form.banner.BannerPosition("bottom-right")
Form.banner.DrawBanner()

Libre à vous ensuite de tester les différentes possibilités de construction des bannières et de les modéliser à votre convenance.

Rappel sur les restrictions : Le composant prévoit que le texte tienne sur une seule ligne, donc prenez soin de bien adapter la taille de la bannière à la taille de votre texte.

Concernant les types « spinner » et « windowSpinner », il vous suffit de reproduire ce que vous avez fait pour le type « window » en modifiant juste le nom du type. Essayer également de changer l’échelle pour le « spinner » et de modifier l’alignement pour « windowSpinner ». N’oublier pas d’utiliser la formule « StopSinner » pour stopper les animations.

AJUI_Banner classe

Depuis la V18R3, vous pouvez remplacer l'instance retournée par New AJUI_Banner par l'appel de la classe Banner. Les fonctions de la classe Banner utilisent les mêmes noms et les mêmes paramètres que pour les formules obtenable par New AJUI_Banner. 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
    $myBanner:=new AJUI_Banner ()

  //avec la classe
    $myBanner:= AJUI_Banner.new ()