PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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 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
  • Transformer un champ "Libellé" en champ "RTF" (Editeur d'états)
  • Manipuler un champ Libellé
  • Saisir le texte du champ Libellé
  • Modifier un champ Libellé sous l'éditeur d'états
  • 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/iPadApple WatchUniversal Windows 10 AppWindows Mobile
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 :
  • WINDEViPhone/iPad Le style du champ, en paramétrant l'élément "Ombre".
    Libellé avec ombre
    WINDEVAndroidWidget AndroidiPhone/iPad Le style du champ, en paramétrant l'élément "Ombre".
    Libellé avec ombre
    Versions 22 et supérieures
    AndroidWidget Android L'ombre est désormais disponible sur les champs Libellé.
    Nouveauté 22
    AndroidWidget Android L'ombre est désormais disponible sur les champs Libellé.
    AndroidWidget Android L'ombre est désormais disponible sur les champs Libellé.
  • 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
WEBDEV - Code Serveur
  • Les champs libellé HTML : le contenu du champ est directement saisi sous l'éditeur de pages. Il est possible de :
    • mettre en forme (gras, italique, ...) une partie du libellé HTML.
    • Versions 17 et supérieures
      utiliser les couleurs de l'ambiance.
      Nouveauté 17
      utiliser les couleurs de l'ambiance.
      utiliser les couleurs de l'ambiance.
    • Versions 17 et supérieures
      surligner le texte avec une couleur (si le navigateur utilisé supporte HTML5, le surlignage utilise cette norme).
      Nouveauté 17
      surligner le texte avec une couleur (si le navigateur utilisé supporte HTML5, le surlignage utilise cette norme).
      surligner le texte avec une couleur (si le navigateur utilisé supporte HTML5, le surlignage utilise cette norme).
    • définir un lien sur une partie du libellé.
    • d'utiliser un style CSS spécifique.
Remarques :
  • Versions 15 et supérieures
    WINDEVWINDEV MobileWindows Mobile 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.
    Nouveauté 15
    WINDEVWINDEV MobileWindows Mobile 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.
    WINDEVWINDEV MobileWindows Mobile 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.
  • WEBDEV - Code Serveur A partir de la version 20, il n'est plus possible de créer des champs Libellé HTML. Les champs Libellé HTML existants sont conservés par compatibilité.
Versions 15 et supérieures
WINDEV MobileAndroid Les champs libellé sont désormais disponibles pour les applications Android.
Nouveauté 15
WINDEV MobileAndroid Les champs libellé sont désormais disponibles pour les applications Android.
WINDEV MobileAndroid Les champs libellé sont désormais disponibles pour les applications Android.
Versions 16 et supérieures
WINDEV MobileUniversal Windows 10 App Ce type de champ est désormais disponible pour les applications Windows Phone.
WINDEVLinux Ce type de champ est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
WINDEV MobileUniversal Windows 10 App Ce type de champ est désormais disponible pour les applications Windows Phone.
WINDEVLinux Ce type de champ est désormais disponible pour les applications WINDEV sous Linux.
WINDEV MobileUniversal Windows 10 App Ce type de champ est désormais disponible pour les applications Windows Phone.
WINDEVLinux Ce type de champ est désormais disponible pour les applications WINDEV sous Linux.
Versions 17 et supérieures
WINDEV MobileiPhone/iPad Ce type de champ est désormais disponible pour les applications iPhone/iPad.
Nouveauté 17
WINDEV MobileiPhone/iPad Ce type de champ est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileiPhone/iPad Ce type de champ est désormais disponible pour les applications iPhone/iPad.
Versions 18 et supérieures
WINDEV MobileWidget Android Ce type de champ est désormais disponible pour les fenêtres de type Widget Android.
WINDEVWINDEV MobileUniversal Windows 10 App Ce type de champ est désormais disponible pour les applications en mode Windows Store apps.
Nouveauté 18
WINDEV MobileWidget Android Ce type de champ est désormais disponible pour les fenêtres de type Widget Android.
WINDEVWINDEV MobileUniversal Windows 10 App Ce type de champ est désormais disponible pour les applications en mode Windows Store apps.
WINDEV MobileWidget Android Ce type de champ est désormais disponible pour les fenêtres de type Widget Android.
WINDEVWINDEV MobileUniversal Windows 10 App Ce type de champ est désormais disponible pour les applications en mode Windows Store apps.
Créer un champ Libellé
WINDEVWINDEV MobileAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJava

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

Pour créer un champ de type Libellé dans une fenêtre ou un état :
  1. Sous l'éditeur de fenêtres ou d'états, cliquez sur l'icône Libellé. Il est également possible de sélectionner l'option :
    • "Insertion .. Champ .. Libellé" dans l'éditeur de fenêtres.
    • "Insertion .. Nouveau champ .. Libellé" dans l'éditeur d'états.
    Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur Libellé.
  2. Cliquez dans la fenêtre ou 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.
Remarques :
  • AndroidWidget AndroidUniversal Windows 10 AppJava Les états ne sont pas disponibles.
  • Versions 19 et supérieures
    WINDEV 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é.
    Nouveauté 19
    WINDEV 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 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é.
  • Versions 21 et supérieures
    WINDEV Les champs Libellé multiligne peuvent être justifiés (option "Cadrage horizontal : Justifié").
    Nouveauté 21
    WINDEV Les champs Libellé multiligne peuvent être justifiés (option "Cadrage horizontal : Justifié").
    WINDEV Les champs Libellé multiligne peuvent être justifiés (option "Cadrage horizontal : Justifié").
WINDEVWINDEV MobileAndroidWidget AndroidiPhone/iPadWindows MobileUniversal Windows 10 AppJava

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 :
  • AndroidWidget AndroidUniversal Windows 10 AppJava Les états ne sont pas disponibles.
  • Versions 19 et supérieures
    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é.
    Nouveauté 19
    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 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é.
  • Versions 21 et supérieures
    WINDEV Dans une fenêtre, les champs Libellé multiligne peuvent être justifiés (option "Cadrage horizontal : Justifié").
    Nouveauté 21
    WINDEV Dans une fenêtre, les champs Libellé multiligne peuvent être justifiés (option "Cadrage horizontal : Justifié").
    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 l'éditeur de fenêtres, cliquez sur l'icône Libellé (ou sélectionnez l'option "Insertion .. Champ .. Libellé").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 "Détail", sélectionnez l'option "Texte avec mise en forme (RTF)".
  4. Dans l'onglet "Général", 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 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.
  • Versions 16 et supérieures
    Il est également possible d'utiliser la propriété ..RichEdit pour modifier le type RTF d'un champ Libellé par programmation.
    Nouveauté 16
    Il est également possible d'utiliser la propriété ..RichEdit pour modifier le type RTF d'un champ Libellé par programmation.
    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 l'éditeur de pages, cliquez :
    • sur l'icône Libellé (ou sélectionnez l'option "Insertion .. Champ .. Libellé") pour créer un champ Libellé simple.
    • sur l'icône Libellé HTML (ou sélectionnez l'option "Insertion .. Champ .. Libellé Html") pour créer un champ Libellé HTML.
    Sous le volet "Création", dans le groupe "Champs usuels", cliquez sur Libellé.Sous le volet "Création", dans le groupe "Champs usuels", déroulez "Texte" et sélectionnez "Libellé".
    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.
Pour créer un champ de type Libellé HTML dans une page :
  1. Sous le volet "Création", dans le groupe "Champs usuels", déroulez "Libellé".Sous le volet "Création", dans le groupe "Champs usuels", déroulez "Texte".
  2. Sélectionnez "Libellé HTML (Compatible)".
  3. Cliquez dans la page à la position où le champ doit être créé. Le champ apparaît en création.
Versions 19 et supérieures
Remarque : Il est conseillé de remplacer le champ Libellé HTML par le champ Zone de Texte Riche.
Nouveauté 19
Remarque : Il est conseillé de remplacer le champ Libellé HTML par le champ Zone de Texte Riche.
Remarque : Il est conseillé de remplacer le champ Libellé HTML par le champ Zone de Texte Riche.
WINDEVWEBDEV - Code ServeurWindows Mobile

Transformer un champ "Libellé" en champ "RTF" (Editeur d'états)

Pour afficher du texte au format RTF dans un champ "Libellé", cochez l'option "Format RTF" dans l'onglet "Détail" de la description du champ.
Le champ "Libellé" se transforme alors en champ "RTF". Toutes les caractéristiques du champ "Libellé" sont conservées. Pour plus de détails, consultez Champ RTF.
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é.
WINDEVWEBDEV - Code Serveur Dans le cas des libellés HTML ou de libellés RTF, il est possible de mettre en forme chaque élément du libellé grâce à une barre d'outils.
WINDEVWEBDEV - Code ServeurEtats et RequêtesiPhone/iPadWindows Mobile

Modifier un champ Libellé sous l'éditeur d'états

Deux méthodes sont possibles :
  • Méthode 1 :
    1. Sélectionnez le champ. Les poignées de sélection apparaissent autour du champ.
    2. Cliquez une nouvelle fois sur le champ. Le curseur de la souris se transforme en curseur de saisie.
    3. Saisissez le nouveau libellé du champ.
    4. Modifiez si nécessaire la mise en forme du libellé grâce à la barre de mise en forme.
    5. Dès qu'un clic est effectué en dehors du champ, le champ repasse en affichage.
  • Méthode 2 :
    1. Sélectionnez le champ.
    2. Affichez la fenêtre de description du champ (option "Description" du menu contextuel).
    3. Saisissez le nouveau libellé dans chaque langue gérée par le champ.
    4. Modifiez si nécessaire la mise en forme du libellé dans l'onglet "Style".
WINDEVWEBDEV - Code ServeuriPhone/iPadWindows Mobile

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 "Général", cochez l'option "Définir comme une ancre".
    3. Validez.
  • Versions 15 et supérieures
    WINDEVAndroidWindows Mobile 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.
    Nouveauté 15
    WINDEVAndroidWindows Mobile 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.
    WINDEVAndroidWindows Mobile 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