DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Zone multiligne
  • Caractéristiques de la ligne dynamique ajoutée
  • Cas d'erreur
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
Ajoute une nouvelle ligne dynamique dans un champ Zone multiligne. Cette ligne est ajoutée à la fin de la zone des lignes dynamiques.
La ligne dynamique a été précédemment définie en édition (ligne avec l'option "Définir comme étant la ligne répétée du champ" cochée dans l'onglet "Général" de la fenêtre de description du champ).
Exemple
// Ajout d'un réseau
nLigne est un entier
nLigne = ZM_Réseau.AjouteLigne()
ZM_Réseau[nLigne].LIB_NomReseau = "Réseau"
ZM_Réseau[nLigne].IMG_Disponible.Visible = Vrai
Syntaxe
<Résultat> = <Champ Zone multiligne>.AjouteLigne()
<Résultat> : Entier
Indice de la ligne ajoutée.
<Champ Zone multiligne> : Nom de champ
Nom du champ Zone multiligne à manipuler.
Remarques

Caractéristiques de la ligne dynamique ajoutée

  • Par défaut, la ligne dynamique ajoutée est vide.
  • Pour personnaliser la ligne (libellé, couleur, visibilité d'éléments, ...), il faut modifier les champs avec la syntaxe suivante :
    <Champ Zone multiligne>[<Indice>].<Nom du champ>.<Propriété> = <Valeur>

    Par exemple :
    nLigne est un entier = ZM_Produits.AjouteLigne()
    ZM_Produits[nLigne].LIB_NomProdLigne = stLigne.sLibProd
    ZM_Produits[nLigne].LIB_NomProdLigne.Couleur = BleuClair
    ZM_Produits[nLigne].SAI_QteLigne = stLigne.nQuantite
  • Par défaut, la ligne ajoutée n'est pas sélectionnée. Pour sélectionner la ligne ajoutée, il suffit d'affecter la valeur de l'indice de la ligne au champ Zone multiligne.
    Par exemple :
    nLigne est un entier = ZM_Produits.AjouteLigne()
    ZM_Produits = nLigne
    ou
    nLigne est un entier = ZM_Produits.AjouteLigne()
    ZM_Produits.Valeur = nLigne
  • Lors de l'ajout de la ligne dynamique, les événements d'initialisation des champs présents dans la ligne sont exécutés.
  • La taille du champ Zone multiligne est modifiée pour prendre en compte la ligne ajoutée : le champ s'agrandit vers le bas. Si des champs sont situés sous le champ Zone multiligne, ils sont déplacés vers le bas. La hauteur utile de la fenêtre est agrandie en conséquence : il est possible de faire défiler la fenêtre avec le doigt pour voir le bas du champ Zone multiligne et les champs éventuellement présents en dessous de cette zone.

Cas d'erreur

Une erreur apparaît dans les cas suivants :
  • aucune ligne dynamique n'a été définie dans le champ Zone multiligne.
  • plus de 300 lignes dynamiques existent dans le champ Zone multiligne.
  • un des traitements d'initialisation des champs de la ligne entraîne une erreur.
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/06/2023

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