Propriétés d'une variable

Calculs personnalisés

Une variable permet d'effectuer des calculs personnalisés. Ces calculs peuvent être utilisés pour des opérations telles que des sommes, des moyennes, des comptages, ou tout autre type de calcul spécifique à vos besoins. Pour définir les opération à faire dans la variable, vous devez aller sur l'onglet Calcul. Les calculs sont généralement placés dans l'événement OnCalc.

Pour en savoir plus sur la création de calcul, vous pouvez consulter le chapitre sur l'onglet Calculs,

Apperance

Nom	Fonction
BlankWhenZero	Lorsque cette propriété est activée, la valeur zéro est remplacé par un vide pour les variables de types numériques.
Border	Cette propriété sert à définir les bordures sur la variable système. Vous retrouverez le descriptif de ces propriétés sur cette page Border
Color	Cette propriété permet de définir la couleur de fond de la variable système. Attention Le code de la couleur est au format hexadécimal. https://docwiki.embarcadero.com/RADStudio/Sydney/en/Colors_in_the_VCL.
HyperLink	Cette propriété permet de rattacher le texte à un hyperlien, il faut indiquer l'url ou l'adresse email. Dès que la propriété, le texte devient cliquable.
HyperLinkColor	Cette propriété permet d'indiquer la couleur du texte de l'hyperlien. Attention Le code de la couleur est au format hexadécimal. https://docwiki.embarcadero.com/RADStudio/Sydney/en/Colors_in_the_VCL.
HyperLinkEnabled	Cette propriété permet d'activer ou désactiver l'hyperlien. Par défaut elle est toujours activé.
HyperLinkHint	Cette propriété permet l'info-bulle qui sera affiché lors du survol de l'hyperlien.
ReprintOnSubsequent	Cette propriété est utilisée en conjonction avec la propriété SuppressRepeatedValues. Cependant, lorsque des lignes de détail débordent sur une nouvelle page, il peut être utile de forcer la réimpression de la valeur sur la première ligne de détail de cette nouvelle page pour maintenir la clarté et la lisibilité du rapport.
SuppresRepeatValues	Lorsque SuppressRepeatedValues est activée, les valeurs répétées sont supprimées pour éviter la redondance.
Transparent	Cette propriété permet de rendre le fond l'objet transparent, la couleur définit la propriété Color ne sera alors pas visible.
Visible	Cette propriété rend la variable système invisible à l'impression lorsqu'elle n'est pas cochée.
:::

Calculations

Nom	Fonction
CalcComponent	Cette propriété permet de spécifier le groupe ou la vue (datapipeline) qui notifiera la variable lorsqu'il est temps de calculer sa valeur. Cette propriété n'est pas valide lorsque le type de calcul CalcType a été défini sur le type veTraversal.
CalcOrder	Cette propriété permet de définir l'ordre de calcul par rapport aux autres variables de la bande.
CalcType	Cette propriété détermine quand la valeur d'un composant de variable est calculée dans le rapport. Par défaut, cette propriété est définie sur veTraversal, ce qui signifie que la valeur est calculée chaque fois que le moteur de rapport traverse un enregistrement. Cependant, d'autres valeurs peuvent être utilisées pour calculer la valeur à des moments spécifiques, comme au début ou à la fin d'une page, d'une colonne, d'un groupe, ou du rapport. Les différentes valeurs possibles sont : veTraversal La valeur est calculée chaque fois que le moteur de rapport traverse un enregistrement, veDataPipelineTraversal La valeur est calculée chaque fois qu'un pipeline de données traverse un enregistrement, vePageStart La valeur est calculée au début de chaque page, vePageEnd La valeur est calculée à la fin de chaque page, veColumnStart La valeur est calculée au début de chaque colonne, veColumnEnd La valeur est calculée à la fin de chaque colonne, veReportStart La valeur est calculée au début du processus de génération du rapport, veReportEnd La valeur est calculée à la fin du processus de génération du rapport, veGroupBeforeHeader La valeur est calculée avant l'impression de l'en-tête de groupe. Utile pour calculer la valeur chaque fois que l'en-tête de groupe est imprimé. Cependant, cela peut déclencher l'événement OnCalc sur les pages suivantes, ce qui n'est généralement pas approprié pour les comptages ou les sommes. Utilisez veGroupEnd si vous avez besoin de corréler OnCalc avec une rupture de groupe, veGroupBeforeFooter La valeur est calculée avant l'impression du pied de page de groupe, veGroupStart La valeur est calculée au début de chaque groupe, veGroupEnd La valeur est calculée à la fin de chaque groupe.
LookAhead	Cette propriété permet d'afficher des calculs de résumé dans des bandes spécifiques du rapport, comme le titre, l'en-tête de page, l'en-tête de groupe, ou l'en-tête de colonne, et avant que ces calculs ne soient normalement disponibles.
ResetComponent	Cette propriété permet de spécifier le groupe ou la vue (datapipeline) qui notifiera la variable lorsqu'il est temps de réinitialiser sa valeur. Cette propriété n'est pas valide quand le type de réinitialisation ResetType a été défini sur le type veTraversal.
ResetType	Cette propriété détermine quand la valeur d'un composant de variable est réinitialisée dans le rapport. Par défaut, cette propriété est définie sur veReportEnd, ce qui signifie que la valeur est réinitialisée à la fin du processus de génération du rapport. Cependant, d'autres valeurs peuvent être utilisées pour réinitialiser la valeur à des moments spécifiques, comme au début ou à la fin d'une page, d'une colonne, d'un groupe, ou du rapport. Les types disponibles sont les mêmes que pour la propriété CalcType.
:::

Data

Nom

Fonction

DataType

Cette propriété détermine le type de la données de la variable. Par défaut, cette propriété est définie sur dtString, ce qui signifie que la variable est traitée comme une chaîne de caractères. Cependant, d'autres types de données peuvent être spécifiés : dtBLOB - La variable est traitée comme un objets binaires de grande taille (par exemple : images, documents PDF), dtBoolean - La variable est traitée comme une valeur booléenne (vrai/faux), dtChar - La variable est traitée comme une valeur avec des caractères uniques (par exemple : une lettre, un chiffre, ou un symbole), dtCurrency - La variable est traitée comme une valeur monétaire, dtDate - La variable est traitée comme une date, dtDateTime - La variable est traitée comme une date et une heure combinées, dtDouble - La variable est traitée comme un nombre à virgule flottante, dtExtended - La variable est traitée comme un nombre à virgule flottante, dtGraphic - La variable est traité comme une image, dtInteger - La variable est traitée comme un entier, dtLargeInt - La variable est traitée comme un entier, dtLongint - La variable est traitée comme un entier, dtMemo - La variable est traitée comme un champ de texte illimité, dtNotKnown - La variable a un type indéfini, dtSingle La variable est traitée comme un nombre à virgule flottante, dtString La variable est traitée comme une chaîne de caractères, dtTime La variable est traitée comme une heure, dtVariant La variable est traitée comme un type de données variant, pouvant contenir différents types de données.

Gestimum

Ces propriétés utilisent des éléments qui sont défini dans le menu Outils\Styles d'impression ReportBuilder. Vous retrouverez le descriptif de ces propriétés sur cette page Styles d'impression

Identity

Nom	Fonction
UserName	Cette propriété permet de nommer l'objet. Il est important de donner un nom à tous vos objets pour gagner en visibilité dans l'arborescence et pour utiliser les objets dans l'onglet Calcul.

Layout - Mise en page

Vous retrouverez la définition de ces propriétés communes à tous les objets sur cette page Layout - Mise en page.

Layout - Dynamic - Mise en page dynamique

Nom	Fonction
Anchors	Ces propriétés permettent d'ancrer la variable à une position précise dans l'objet parent. Les valeurs possibles sont atBottom - Ancré avec le bas, atLeft - Ancré avec la gauche, atRight - Ancré avec la droite, atTop - Ancré avec le haut, Si toutes les propriétés sont cochées, cela revient à cocher ParentHeight et ParentWidth.
AutoSize	Cette propriété permet d'ajuster la longueur de la variable avec son contenu.
Ellipsis	Cette propriété permet d'ajouter 3 points "..." à la fin du texte de la variable quand le la propriété AutoSize n'est pas activée.
ReprintOnOverFlow	Cette propriété s'applique aux situations où des objets de la même bande sont extensible (Strech) et s'étendent sur plusieurs pages. S'ils débordent sur une nouvelle page, les autres objets situés sur la même bande seront réimprimés sur la nouvelle page si cette propriété est activée. Par défaut, cette propriété est désactivée.
StretchWithParent	Cette propriété détermine si la hauteur de la variable doit s'étirer pour correspondre à l'étirement de la bande parente.

Output - File

Nom	Fonction
Save	Cette propriété permet d'indiquer si le contenu de la variable sera sauvegardé lors de l'export dans un fichier texte.
SaveLenght	Cette propriété permet d'indiquer la taille du contenu de la variable à sauvegarder dans un fichier texte. Si la valeur du texte de la variable est plus grande que cette longueur, elle sera tronquée. Si la longueur de la valeur du texte est inférieure à SaveLength, des espaces sont ajoutés pour compléter la valeur. Les espaces sont ajoutés à gauche, à droite, ou des deux côtés (pour un alignement centré) en fonction de la propriété Alignment.
SaveOrder	Cette propriété définit la position relative du composant textuel au sein de la ligne de texte.

Text

Nom	Fonction
Angle	Cette propriété permet de contrôler l'angle auquel le texte est affiché. Les valeurs d'angle doivent être des nombres entiers et sont calculées en degrés. Les valeurs d'angle comprises entre 1 et 359 font tourner le texte dans le sens antihoraire, tandis que les valeurs d'angle comprises entre -359 et -1 font tourner le texte dans le sens horaire. Les fonctionnalités AutoSize et Alignement du Texte sont prises en charge pour le texte incliné, mais le retour à la ligne automatique (WordWrap ou CharWrap) n'est pas pris en charge.
CharWrap	Cette propriété permet d'indiquer si le retour à la ligne peut couper un mot lorsque le texte dépasse la taille de la variable. Attention, il faudra ajuster la hauteur de la variable en conséquence pour que tout le texte soit affiché.
DisplayFormat	Cette propriété permet de contrôler la manière dont les données sont formatées pour un rapport. Elle peut être utilisée pour formater des nombres, des dates, des heures, et même des chaînes de caractères en utilisant des masques d'édition (EditMask).
Font	Cette propriété sert à définir la police (Font) de la variable. Vous retrouverez le descriptif de ces propriétés sur cette page Font.
RTLReading	Lorsque cette propriété est activé, le sens de lecture est changé, il va de la droite vers la gauche. Cette propriété est utile pour les langues Arabe ou Hébreu notamment.
TextAlignment	Cette propriété définit l'alignement du texte dans la variable. Les valeurs possibles sont taLeftJustified - Texte aligné à gauche, taCentered - Texte centré, taRightJustified - Texte aligné à droite, taFullJustified - Texte justifié.
VerticalAlignment	Cette propriété définit l'alignement vertical du texte dans la variable. Les options d'alignement vertical sont avTop - Aligne le contenu en haut de la variable, Center - Centre le contenu verticalement au milieu de la variable, Bottom - Aligne le contenu en bas de la variable.
WordWrap	Cette propriété permet d'ajuster automatiquement le texte à la taille du champ en le faisant automatiquement des retours à la ligne.