DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Libellé
  • Présentation du champ Libellé
  • Champ d'une fenêtre, d'une page (statique ou dynamique), d'un état
  • Créer un champ Libellé dans une fenêtre ou une page
  • Créer un champ Libellé dans une fenêtre ou une page
  • Gestion des libellés trop longs
  • Cas particulier : Champ Libellé au format RTF
  • Créer un champ Libellé dans un état
  • Créer un champ Libellé dans un état
  • Contenu d'un champ Libellé
  • Saisir le texte du champ Libellé sous l'éditeur
  • Contenu d'un champ Libellé (Éditeur d'états)
  • Notes
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Présentation du champ Libellé

Champ d'une fenêtre, d'une page (statique ou dynamique), d'un état

Un champ Libellé est un champ qui permet d'afficher un texte statique. Le contenu du champ ne pourra pas être saisi par l'utilisateur.
Pour donner des effets au texte affiché, il est possible d'utiliser :
  • WINDEVAndroidWidget AndroidiPhone/iPad Le style du champ, en paramétrant l'élément "Ombre".
    Libellé avec ombre
  • WINDEV Le type "RTF" pour afficher un texte au format RTF.
    Libellé RTF
  • WINDEVAndroidiPhone/iPad Une animation spécifique (défilement ou clignotement).
    Libellé défilant
    Nouveauté 2025
    Cette fonctionnalité est désormais disponible en Android et iOS.
WINDEVAndroidWidget AndroidiPhone/iPad Remarques :
  • Les libellés d'une fenêtre peuvent être également paramétrés avec un masque d'affichage pour formater automatiquement la valeur qui leur est affectée.
  • L'onglet "Style" de la fenêtre de description du champ permet de paramétrer de nombreux effets pour le champ Libellé. Il est notamment possible de :
    • paramétrer le cadre du champ. Cette option permet par exemple d'afficher une image dans un champ Libellé.
      L'icône (à droite de l'option "Cadre") permet de configurer l'ombre du cadre du champ. Lorsque l'ombre est activée, il est possible de choisir le décalage en X et Y de l'ombre, le pourcentage d'opacité, le rayon de flou et la couleur de l'ombre.
    • paramétrer les caractéristiques de la police utilisée via le bouton . Il est possible d'indiquer :
      • l'interligne,
      • l'espacement des caractères,
      • WINDEViPhone/iPad l'angle correspondant à l'orientation du texte.
Créer un champ Libellé dans une fenêtre ou une page

Créer un champ Libellé dans une fenêtre ou une page

Pour créer un champ de type Libellé dans une fenêtre ou une page :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur Libellé.
  2. Cliquez dans la fenêtre ou dans la page à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ. Vous pourrez saisir par exemple le texte affiché dans le champ ou définir le type des informations affichées dans le champ.

Gestion des libellés trop longs

En cas de libellé trop long, plusieurs solutions peuvent être mise en oeuvre :
  • WINDEVAndroidWidget AndroidiPhone/iPad Réduire la police :
    Il est possible de définir une taille de police minimale pour le le texte en cas de libellé trop long (option "Réduire la police" dans l'onglet "Détail" de la fenêtre de description du champ).
  • Afficher une ellipse : il est possible de mettre en place une ellipse. L'ellipse consiste à remplacer le texte trop long par trois points.
    • WEBDEV - Code ServeurPHP Dans une page, le texte du libellé peut uniquement être tronqué à la fin, en matérialisant la fin du texte par trois points. L'option "Tronquer avec une ellipse à la fin" est disponible dans l'onglet "UI" de la fenêtre de description du champ.
    • WINDEVAndroidWidget AndroidiPhone/iPad Dans une fenêtre, il est possible de proposer une ellipse soit en fin soit au milieu du texte trop long. La gestion de l'ellipse est définie dans l'onglet "Détail" du champ Libellé.
    • WINDEVAndroidWidget AndroidiPhone/iPad Proposer une animation : L'animation peur en effet permettre de faire défiler le texte du libellé. Ainsi, l'utilisateur verra la totalité du texte lors de l'animation. Pour plus de détails sur la mise en place de l'animation, consultez Animer un champ Libellé.
      Nouveauté 2025
      AndroidWidget AndroidiPhone/iPad L'animation des libellés est désormais disponible.
WINDEVJava

Cas particulier : Champ Libellé au format RTF

Pour créer un champ de type Libellé au format RTF dans une fenêtre :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur Libellé.
  2. Affichez la fenêtre de description du champ (option "Description" du menu contextuel).
  3. Dans l'onglet "Général" :
    • Sélectionnez le type du champ Libellé : "RTF".
    • Saisissez le texte du libellé au format RTF : une barre d'outils spécifique apparaît automatiquement permettant de mettre en forme le texte saisi.
Remarques :
  • Il est également possible de créer un champ Libellé au format RTF via le champ Métier "Libellé RTF".
  • Il est également possible de créer un libellé RTF en réalisant un copier - coller d'un texte RTF directement dans la fenêtre.
  • Pour utiliser un champ Libellé au format RTF, le fichier "RICHED20.DLL" doit être présent sur le poste en cours. Le fichier "RICHED20.DLL" est généralement présent dans le répertoire système de Windows.
  • Il est également possible d'utiliser la propriété RichEdit pour modifier le type RTF d'un champ Libellé par programmation.
Créer un champ Libellé dans un état
WINDEVWEBDEV - Code ServeurAndroidiPhone/iPad

Créer un champ Libellé dans un état

Pour créer un champ de type Libellé dans un état :
  1. Sous le volet "Création", dans le groupe "Texte", cliquez sur Libellé.
  2. Cliquez dans l'état à la position où le champ doit être créé. Le champ apparaît en création.
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ. Vous pourrez saisir par exemple le texte affiché dans le champ ou définir le type des informations affichées dans le champ.
Remarques : L'onglet "UI" de la description du champ Libellé dans l'éditeur d'états permet de gérer de nombreuses options, notamment l'ellipse, l'affichage conditionnel, etc.).
Contenu d'un champ Libellé
Un champ Libellé peut afficher des informations :
  • saisies sous l'éditeur.
  • définies par programmation.
  • provenant d'un fichier de données. Dans ce cas, le champ Libellé est relié à une rubrique d'un fichier de données. Le champ permet alors de visualiser le contenu des rubriques du fichier de données.

Saisir le texte du champ Libellé sous l'éditeur

Pour saisir le texte du champ Libellé :
  1. Cliquez dans le champ Libellé sous l'éditeur. Le curseur de saisie apparaît.
  2. Saisissez le texte du champ Libellé.
    WINDEV Dans le cas des libellés RTF (dans une fenêtre ou un état), il est possible de mettre en forme chaque élément du libellé grâce à une barre d'outils.
Remarque : Le texte du champ Libellé peut également être modifié dans la fenêtre de description du champ.
WINDEVWEBDEV - Code ServeurAndroidWidget AndroidiPhone/iPad

Contenu d'un champ Libellé (Éditeur d'états)

  • La chaîne de caractères affichée dans le champ Libellé peut contenir la valeur d'une rubrique imprimée dans l'état. Pour insérer la valeur d'une rubrique ou d'un champ de l'état dans le texte du libellé, saisissez le nom de la rubrique ou du champ entre les caractères [% et %].
    Par exemple, le libellé du champ peut correspondre à :
    Le fournisseur [%NomFournisseur%] vend le produit [%NomProduit%] pour [%PrixTTC%].
    Les rubriques NomFournisseur, NomProduit et PrixTTC seront remplacées par leur valeur à l'exécution de l'état.
  • Ce libellé peut être saisi sur plusieurs lignes. Dans ce cas, le champ doit être multiligne et la taille du champ doit être suffisante.
    Remarque : Si un angle d'orientation est appliqué à un champ multiligne, les retours chariot automatiques ne sont pas pris en compte. Seuls les retours à la ligne manuels sont pris en compte.
Rappel : L'option "Auto-Extensible" permet d'augmenter automatiquement la taille du champ en fonction de son contenu.
Notes
  • WEBDEV - Code Serveur Pour afficher des données numériques (montant, date, heure, etc.), utilisez le champ d'affichage formaté : les données seront affichées selon le masque de saisie sélectionné.
  • WEBDEV - Code Serveur Pour définir une ancre sur un champ Libellé :
    1. Affichez la fenêtre de description du champ.
    2. Dans l'onglet "UI", cochez l'option "Définir comme une ancre".
    3. Validez.
  • WINDEVAndroid Dans les fenêtres, les champs Libellé disposent d'un masque d'affichage pour formater automatiquement les données qui leurs sont affectées. Ce masque peut être modifié en programmation grâce à la propriété MasqueSaisie.
Liste des exemples associés :
Le champ Libellé Exemples unitaires (WINDEV) : Le champ Libellé
[ + ] Utilisation d'un champ Libellé
Gestion du RTF Exemples unitaires (WINDEV) : Gestion du RTF
[ + ] Utilisation des principales fonctions de gestion du RTF dans une application WINDEV :
- Charger un fichier au format RTF
- Enregistrer un fichier au format RTF
- Rechercher et sélectionner un mot dans un texte RTF
- Afficher un texte au format RTF
- Modifier les caractéristiques d'une sélection (police, casse, couleur...)
Propriété ClasseHTML Exemples unitaires (WEBDEV) : Propriété ClasseHTML
[ + ] La propriété ..ClasseHTML permet de lire et de modifier la valeur de l'attribut HTML "class" du champ.
La valeur de l'attribut HTML "class" permet, entre autres, de sélectionner les styles CSS appliqués sur le champ.
WW_NuageTags Composants (WEBDEV) : WW_NuageTags
[ + ] Cet exemple montre comment afficher un nuage de tags dans une application WEBDEV dynamique.
En effet, sur Internet, une page d'un site répond plus ou moins à un ensemble de mots-clés.
L'objectif de cet exemple est donc de présenter comment afficher les mots-clés d'un site dans une zone de la page en indiquant de manière graphique les mots-clés importants.
Les mots-clés se retrouvent alors sous forme de liens de différentes tailles : plus le mot-clé est important dans le site, plus sa police est élevée.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/09/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale