Propriétés d'un label

Saisie du texte

Vous pouvez saisir le texte que doit contenir le label soit dans la zone de la barrer d'outils soit dans la propriété Caption de la partie Text. Vous retrouverez également une partie des éléments pour le mettre en forme dans cette barre d'outils.

Apperance

Nom	Fonction
Border	Cette propriété sert à définir les bordures sur le label. 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 du label. 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.
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 le label invisible à l'impression lorsqu'elle n'est pas cochée.
:::

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 le label à 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 du label avec son contenu.
Ellipsis	Cette propriété permet d'ajouter 3 points "..." à la fin du texte du label 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 du label doit s'étirer pour correspondre à l'étirement de la bande parente.

Output - File

Nom	Fonction
FormFieldSettings	Ces propriétés permettent de paramétrer de définir comment un champ de formulaire sera exporté et affiché dans le fichier PDF généré. Cela peut inclure des options telles que la visibilité, la position, le formatage, et d'autres propriétés spécifiques au champ.
FieldCharacterSeparator	Lorsque cette propriété est définie sur True, le champ de texte est automatiquement divisé en autant de positions équidistantes, que la valeur de la propriété FieldMaxLength (elle doit être aussi différente de zéro). Il faut aussi que les propriétés FieldMultiline et FieldPassword ne soient pas activées.
FieldMaxLenght	Cette propriété permet de limiter le nombre de caractères saisissables dans le champs de formulaire. Quand la valeur est à zéro, le nombre de caractères est illimité.
FieldMultiline	Lorsque cette propriété est activée, le texte peut être saisi sur plusieurs lignes.
FieldPassword	Cette propriété permet de définir le champ comme étant un mot de passe. Lorsqu'elle est activé, le texte saisi ne sera pas affiché lisiblement à l'écran. De plus, la valeur du mot de passe ne sera pas enregistrée lorsque le PDF est sauvegardé dans un fichier.
FieldReadOnly	Lorsque la propriété est activée, le champ passe en lecture seule. Le contenu ne peut pas être modifié.
FieldRequired	Cette propriété permet de rendre obligatoire la saisie dans le champ.
FieldTitle	La propriété permet de définir le titre d'un champ d'entrée PDF. Ce titre est utilisé pour le post-traitement et l'identification du champ lorsque le formulaire est soumis. Le titre est essentiel pour identifier le champ dans les données soumises et pour effectuer des opérations de post-traitement.
FormFieldType	La propriété permet de spécifier le type de champ de formulaire de texte à exporter vers un fichier PDF. Les différents types de champ sont fftText - Champ de texte standard pour saisir du texte simple, fftSignature - Champ de type Signature field qui permettra à l'utilisateur de signer électroniquement le PDF, fftSubmit - Le champ deviendra un bouton qui permettra de valider le formulaire, fftReset - Bouton qui permet de réinitialiser les champs du formulaire dans le PDF.
FormSubmitInfo	Les propriétés qui permettent de configurer les paramètres nécessaires pour soumettre les données du formulaire à un serveur ou à une adresse e-mail.
JavaScript	Cette propriété permet de mettre du code JavaScript qui sera exécuter lorsque l'utilisateur appuiera sur le bouton de validation du formulaire. Pour plus d'informations sur la syntaxe et les extensions supporté par Adobe Acrobat, vous pouvez utiliser cette document sur l'API d'Acrobat http://www.adobe.com/content/dam/Adobe/en/devnet/acrobat/pdfs/js_api_reference.pdf
SubmitMethod	Cette propriété permet de définir ce qui sera utilisé lors de la validation du formulaire. Vous avez 3 choix possibles fstPost - le formulaire PDF fera un POST des données vers l'url, fstGet - le formulaire PDF fera un GET vers l'url pour récupérer des données, fstJavaScript - le formulaire PDF utilisera le code Javascript.
URL	Cette propriété permet d'indiquer l'url ou l'email d'envoi des données.
Save	Cette propriété permet d'indiquer si le contenu du label sera sauvegardé lors de l'export dans un fichier texte.
SaveLenght	Cette propriété permet d'indiquer la taille du contenu du label à sauvegarder dans un fichier texte. Si la valeur du texte du label 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.
Caption	Cette propriété permet de taper le texte qui sera affiché dans le label.
CharWrap	Cette propriété permet d'indiquer si le retour à la ligne peut couper un mot lorsque le texte dépasse la taille du label. Attention, il faudra ajuster la hauteur du label en conséquence pour que tout le texte soit affiché.
Font	Cette propriété sert à définir la police (Font) du label. 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 le label. 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 le label. Les options d'alignement vertical sont avTop - Aligne le contenu en haut du label, Center - Centre le contenu verticalement au milieu du label, Bottom - Aligne le contenu en bas du label.
WordWrap	Cette propriété permet d'ajuster automatiquement le texte à la taille du champ en le faisant automatiquement des retours à la ligne.