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 inséré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
Insère une nouvelle ligne dynamique dans un champ Zone multiligne. Cette ligne est ajoutée à la position indiquée dans la zone des lignes dynamiques.
Exemple
// Ajout d'un réseau
nLigne est un entier = 4
zmlInsèreLigne(ZM_Réseau, nLigne)
ZM_Réseau[nLigne].LIB_NomReseau = "Réseau"
ZM_Réseau[nLigne].IMG_Disponible.Visible = Vrai
Syntaxe
zmlInsèreLigne(<Champ Zone multiligne> , <Position>)
<Champ Zone multiligne> : Nom de champ
Nom du champ Zone multiligne à manipuler.
<Position> : Entier
Indice de la ligne à ajouter.
L'indice "1" correspond à la première ligne du champ Zone multiligne. Toutes les lignes sont numérotées (lignes statiques et lignes dynamiques).
Si le champ Zone multiligne contient des lignes statiques et des lignes dynamiques, il est nécessaire de prendre en compte le nombre de lignes statiques.
Remarques

Caractéristiques de la ligne dynamique insérée

  • Par défaut, la ligne dynamique inséré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 :
    zmlInsèreLigne(ZM_Produits, nLigne)
    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 inséré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 du champ Zone multiligne.
    Par exemple :
    zmlInsèreLigne(ZM_Produits, nLigne)
    ZM_Produits = nLigne
    ou
    zmlInsèreLigne(ZM_Produits, nLigne)
    ZM_Produits.Valeur = nLigne
  • Lors de l'ajout de la ligne dynamique, les traitements 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 inséré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 événements d'initialisation des champs de la ligne entraîne une erreur.
Version minimum requise
  • Version 17
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

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