PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Initialiser un champ Libellé
  • Cas des libellés HTML
  • Conserver la mise en forme dans les libellés HTML
  • Récupérer la valeur d'un champ Libellé
  • Cas des libellés HTML
  • Utilisation avancée des libellés statiques (Code navigateur)
  • Astuce : modifier ou récupérer la valeur d'un libellé statique
  • Propriétés spécifiques à la gestion d'un libellé
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
Manipuler un champ Libellé par programmation
Présentation
WINDEV, WINDEV Mobile et WEBDEV permettent de manipuler un champ Libellé directement par programmation. Il suffit d'utiliser directement la variable du champ Libellé dans le code.
La variable du champ Libellé correspond au nom du libellé. Un champ Libellé est toujours de type Texte.
Initialiser un champ Libellé
Pour initialiser un champ Libellé, une simple affectation de la variable du champ Libellé suffit.
Par exemple :
// Affectation d'un champ Libellé avec le nom et le prénom lus dans le fichier CLIENT
LIB_MonLibellé = Client.Nom + "  " + Client.Prenom
WEBDEV - Code Serveur

Cas des libellés HTML

Pour initialiser un libellé HTML, il est possible d'initialiser le champ directement avec le code HTML. Il est ainsi possible de mettre en forme le libellé HTML par programmation.
Par exemple :
// Modification du libellé
LIBHTM_MODIFIABLE..Libellé = "<B>Cette portion a été " + ...
"modifi&#233;e</B>"
WEBDEV - Code Serveur

Conserver la mise en forme dans les libellés HTML

Par défaut, lors de la modification du libellé affiché dans un champ Libellé HTML, la mise en forme du libellé n'est pas conservée.
Pour conserver la mise en forme lors de la modification du libellé :
  1. Saisissez et mettez en forme le libellé initial du champ (dans la fenêtre de description).
  2. Remplacez les mots du libellé à modifier par l'expression "%<Numéro>". Le paramètre <Numéro> permet d'identifier le mot à modifier. Le premier mot aura le numéro 1, le second le numéro 2, ...
  3. Construisez le nouveau libellé à l'aide de la fonction ChaîneConstruit.
// -- Code d'initialisation du champ "MonLibelléHTML"
MaDate est une chaîne
MaDate = DateVersChaîne(DateSys())
MonHeure est une chaîne
MonHeure = HeureVersChaîne(HeureSys())
LIBHTM_MonLibelléHTML = ChaîneConstruit(LIBHTM_MonLibelléHTML, MaDate, MonHeure)
Récupérer la valeur d'un champ Libellé
Pour récupérer le contenu d'un champ Libellé :
  • réalisez une simple affectation. Par exemple :
    ContenuActuelLibellé = LIB_LIBELLE1
  • manipulez directement le champ Libellé. Par exemple :
    Info(LIB_LIBELLE1)
  • utilisez la propriété ..Valeur ou la propriété ..Libellé.
WEBDEV - Code Serveur

Cas des libellés HTML

Lors de la récupération du contenu d'un champ Libellé HTML, le texte récupéré correspond au code HTML du libellé.
Utilisation avancée des libellés statiques (Code navigateur)
WEBDEV - Code Serveur

Astuce : modifier ou récupérer la valeur d'un libellé statique

Il est possible de récupérer ou de modifier la valeur d'un libellé statique en code navigateur grâce à la fonction JSPropriété.
Rappel : Cette fonction est réservée aux développeurs maîtrisant le JavaScript.
Exemple :
// -- Code de clic (navigateur) du bouton BTN_MODIF
JSPropriété("tz" + "LIBNAVMOD", "innerHTML") = "Libellé statique, ce libellé vient d'être modifié"
Remarque : La chaîne "tz" permet d'identifier le champ Libellé.
Propriétés spécifiques à la gestion d'un libellé
Les propriétés suivantes sont spécifiques à la gestion des caractéristiques d'un champ Libellé par programmation.
AnimationPermet de connaître l'état actuel de l'animation dans un champ Libellé et de lancer ou d'arrêter l'animation d'un champ Libellé animé.
AnimationInitialePermet de connaître l'état initial de l'animation dans un champ Libellé.
EllipsePermet de connaître et modifier le mode de gestion de l'ellipse dans un champ Libellé.
LibelléPermet de connaître et de modifier le libellé du champ.
Versions 22 et supérieures
RetraitBas
Nouveauté 22
RetraitBas
RetraitBas
Permet de connaître et de modifier la marge basse d'un champ Libellé.
Versions 22 et supérieures
RetraitDroit
Nouveauté 22
RetraitDroit
RetraitDroit
Permet de connaître et de modifier la marge droite d'un champ Libellé.
Versions 22 et supérieures
RetraitGauche
Nouveauté 22
RetraitGauche
RetraitGauche
Permet de connaître et de modifier la marge gauche d'un champ Libellé.
Versions 22 et supérieures
RetraitHaut
Nouveauté 22
RetraitHaut
RetraitHaut
Permet de connaître et de modifier la marge haute d'un champ Libellé.
RichEditPermet de connaître et de modifier la caractéristique RTF (Rich Text Format) d'un champ Libellé.
Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Libellé, consultez Propriétés associées à un champ Libellé.
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire