FR 4. Propriétés et formules - AJARProject/AJUI_Banner GitHub Wiki

Une bannière possède un ensemble de propriétés qui vont permettre de définir sa représentation dans le formulaire hôte.

Dans ce chapitre, nous allons passer en revue les différentes propriétés existantes accessibles par une formule faisant office de Setter et également de Getter si on ne leur passe aucun paramètre.

Toutes les formules pourront être appelées au premier niveau de l’objet.

Propriétés liées à la bannière se trouvant au deuxième niveau de l’objet : MyBanner.banner

Formule	Description
BannerName -> string Par défaut : AJUI_Banner_2use or AJUI_cr_2use Paramètre : * Nom de la bannière (string)	nom de la bannière si celle ci est de type windows ou nom du cornerRibbon s'il est du type cornerRibbon.
BannerBGColor -> string Par défaut : black:50 Paramètre : * Couleur de fond (string)	Couleur de fond de la bannière. Il est possible de définir un taux d’opacité (%). Voir valeur par défaut
BannerHeight -> longint Par défaut : 150 Paramètre : * Hauteur de la bannière (longint)	Hauteur de la bannière.
BannerWidth -> longint Par défaut : 400 Paramètre : * Largeur de la bannière (longint)	Largeur de la bannière.
BorderColor -> string Par défaut : darkgray Paramètre : * Couleur de bordure (string)	Couleur de la bordure de la bannière.
BorderSize -> longint Par défaut : 0 Paramètre : * Taille de bordure (longint)	longint Largeur de la bordure de la bannière.
CornerRadius -> longint Par défaut : 15 Paramètre : * Arrondi des angles (longint)	Arrondi des angles de la bannière.
BannerPosition -> string Par défaut : bottom-right Paramètre : * Position bannière "cornerRibbon" (string)	Position de la bannière pour le type « cornerRibbon». Position possible : top-left | top-right | bottom-left | bottom-right
BannerType -> string Par défaut : cornerRibbon Paramètre : * Type de bannière (string)	Type de bannière à utiliser. Type possible : cornerRibbon | window | spinner | windowSpinner

Propriétés liées au contenu textuel se trouvant au deuxième niveau de l’objet : MyBanner.text

Formule	Description
Message -> string Par défaut : AJUI Banner Paramètre : * Message de la bannière (string)	Message qui sera affiché dans la bannière.
TextColor -> string Par défaut : white Paramètre : * Couleur du texte (string)	Couleur du texte du message.
TextFontName -> string Par défaut : Arial Paramètre : * Nom de la police (string)	Nom de la police. Certaines polices peuvent ne pas être compatible SVG.
TextFontSize -> longint Par défaut : 32 Paramètre : * Taille de la police (longint)	Taille de la police.
TextFontStyle -> string Par défaut : normal Paramètre : * Style du texte (string)	Propriété SVG pouvant être appliqué au niveau du texte. Propriété possible : normal | italic | oblique | inherit
TextFontWeight -> string Par défaut : bold Paramètre : * Épaisseur du texte (string)	Propriété SVG pouvant être appliqué au niveau du texte. Propriété possible : normal | bold | bolder | lighter | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900 | inherit

Propriétés liées à la fenêtre se trouvant au deuxième niveau de l’objet : MyBanner.window

Formule	Description
WindowBGColor -> string Par défaut : black:50 Paramètre : * Couleur de fond (string)	Couleur de fond pour l’utilisation de la bannière « window ». Il est possible de définir un taux d’opacité (%). Voir valeur par défaut
WindowRef -> longint Par défaut : 0 Paramètre : * Référence de la fênetre du formulaire (longint)	Référence au formulaire devant recevoir la bannière. La valeur 0 représente le formulaire courant.

Propriétés liées à l’image au deuxième niveau de l’objet : MyBanner.picture

Formule	Description
IsPicture -> boolean Par défaut : False Paramètre : * utiliser une image ou du texte (boolean)	Si vrai, la bannière contient une image, si non la bannière contient un texte. Ne concerne que la bannière « window ».
PicturePath -> string Par défaut : chaîne vide Paramètre : * Chemin de fichier dans les ressources (string)	Chemin de fichier de l’image à afficher. L’image doit se trouver dans le dossier ressources de l'application 4D et le chemin est toujours relatif. Exemple : "Images/info.png" (utilisés la constante folder separator de 4D pour construire la chaîne de façon propre).

Propriétés liées au « spinner » au deuxième niveau de l’objet : MyBanner.banner.spinner

Formule	Description
SpinnerScale -> real Par défaut : 0.5 Paramètre : * Échelle du « spinner » (real)	Mise à l’échelle du « spinner » par rapport à la fenêtre ne s’applique pas pour le type « windowSpinner » car sa taille s’adaptera en fonction de la zone de texte.
WindowSpinnerSide -> string Par défaut : right Paramètre : * Alignement du « spinner » (string)	Alignement du « spinner » par rapport au texte. Valeur possible : left | right

Propriétés liées au « ribbon » au deuxième niveau de l’objet : MyBanner.banner.ribbon

Formule	Description
RibbonTargetName -> string Par défaut : chaîne vide Paramètre : * Nom de l’objet de formulaire (string)	Nom de l’objet de formulaire qui recevra le ruban.
RibbonTargetCoordinates -> object Par défaut : 0 pour chaque coordonnée Paramètre : * Coordonnée gauche (longint) * Coordonnée haut (longint) * Coordonnée droit (longint) * Coordonnée bas (longint)	Coordonnées d’une zone qui recevra le ruban. En mode Getter, la formule retourne un objet contenant les quatre coordonnées.