Dans une base de données, la propriété
Libellé permet de :
- Connaître le libellé associé à une rubrique d'un fichier de données.
Remarque : La rubrique peut avoir été créée sous l'éditeur d'analyses ou par programmation. - Connaître le libellé associé à un fichier de données.
Remarque : Le fichier de données peut avoir été créé sous l'éditeur d'analyses ou par programmation. - Connaître et modifier le libellé d'une connexion. La connexion peut correspondre :
- soit à une connexion décrite sous l'éditeur d'analyses,
- soit à une connexion décrite avec les fonctions HConnecte, HDécritConnexion ou HOuvreConnexion.
- soit à une connexion décrite avec une variable de type Connexion.
Dans un état, la propriété Libellé permet de connaître et de modifier le texte :
- d'un champ Libellé.
- d'un champ Lien.
- d'un champ Graphe.
Dans une fenêtre ou une page, la propriété Libellé permet également de :
- Connaître et modifier le libellé d'un champ présent dans une fenêtre ou une page.
- Connaître et modifier le libellé d'une option de menu.
- Connaître et modifier le titre d'une fenêtre ou d'une page.
Rappel : Le libellé initial d'un champ, d'une fenêtre, d'une page ou d'une option de menu est défini sous l'éditeur lors de la description de l'objet.
// Modifier le texte du champ Libellé "LIB_ChampIntro"
LIB_ChampIntro.Libellé = "Cher Monsieur" + Client.Nom
// Équivalent à : LIB_ChampIntro.Libellé = "Cher monsieur [%Client.Nom%]"
Syntaxe
Connaître le texte du libellé d'un élément Masquer les détails
<Résultat> = <Elément manipulé>.Libellé
<Résultat> : Chaîne de caractères
Texte affiché dans l'élément spécifié.
<Elément manipulé> : Type de l'élément
Nom de l'élément à manipuler.
Modifier le texte du libellé d'un élément Masquer les détails
<Elément manipulé>.Libellé = <Nouveau texte>
<Elément manipulé> : Type de l'élément
Nom de l'élément à manipuler.
<Nouveau texte> : Chaîne de caractères
Nouveau texte affiché dans l'élément spécifié.
Remarques
Contenu d'un champ Libellé
Pour récupérer la valeur d'un champ ou d'une rubrique dans un champ Libellé :
- Sous l'éditeur d'états : insérez [%<Nom du champ>%] ou [%<Nom de la rubrique>%] directement dans le libellé du champ.
- En programmation : deux syntaxes sont possibles avec la propriété Libellé :
- utilisez directement la chaîne [%<Nom du champ>%] ou [%<Nom de la rubrique>%] dans la chaîne correspondant au libellé. Par exemple :
LIB_ChampIntro.Libellé = "Cher monsieur [%Client.Nom%]"
- utilisez le nom du champ ou de la rubrique dans le libellé. Par exemple :
LIB_ChampIntro.Libellé = "Cher monsieur" + Client.Nom
Équivalence
La propriété
Libellé est équivalente à la propriété
Valeur.
Pour récupérer le texte d'un champ Libellé, les syntaxes suivantes sont équivalentes :
ResLibellé = <Champ Libellé>.Libellé
ResLibellé = <Champ Libellé>.Valeur
ResLibellé = <Champ Libellé>
Pour modifier le texte d'un champ Libellé, les syntaxes suivantes sont équivalentes :
<Champ Libellé>.Libellé = <Nouveau texte>
<Champ Libellé>.Valeur = <Nouveau texte>
<Champ Libellé> = <Nouveau texte>