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é
  • Créer un champ Libellé dans une fenêtre ou un état
  • Créer un champ de type Libellé au format RTF dans une fenêtre
  • Créer un champ Libellé dans une page
  • Manipuler un champ Libellé
  • Saisir le texte du champ Libellé
  • Contenu d'un champ Libellé (Éditeur d'états)
  • Notes
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
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
  • WINDEV Une animation spécifique (défilement ou clignotement).
    Libellé défilant
Remarques :
  • WINDEV 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.
  • WINDEVAndroidWidget AndroidiPhone/iPad 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é
WINDEVUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadJava

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

Pour créer un champ de type Libellé dans une fenêtre :
  1. Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur Libellé.
  2. Cliquez dans la fenêtre à la position où le champ doit être créé. Le champ apparaît en création.
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 :
  • Universal Windows 10 AppJava Les états ne sont pas disponibles.
  • WINDEV Dans une fenêtre, les champs Libellé multiligne peuvent gérer l'ellipse : si le libellé est trop long pour rentrer dans son champ, la fin du texte est matérialisée par trois points. La gestion de l'ellipse est définie dans l'onglet "Détail" du champ Libellé.
  • WINDEV Dans une fenêtre, les champs Libellé multiligne peuvent être justifiés (option "Cadrage horizontal : Justifié").
WINDEVJava

Créer un champ de type Libellé au format RTF dans une fenêtre

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.
WEBDEV - Code ServeurPHP

Créer un champ Libellé dans une page

Pour créer un champ de type Libellé dans une page :
  1. Sous le volet "Création", dans le groupe "Champs usuels", déroulez "Texte" et sélectionnez "Libellé simple".
    Libellé
  2. Cliquez 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.
Manipuler un champ Libellé

Saisir le texte du champ Libellé

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
  • Le contenu d'un champ Libellé peut être saisi sous l'éditeur ou défini par programmation.
  • Un champ Libellé peut être relié à une rubrique d'un fichier de données. Le champ permet alors de visualiser le contenu des rubriques du fichier de données.
  • WEBDEV - Code Serveur Pour afficher des données numériques (montant, date, heure, ...), 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 : 11/04/2023

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