DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Zones répétées
  • Conditions d'utilisation
  • Caractéristiques de la répétition
  • Manipulation d'un mémo binaire
  • Tri
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 répétition dans un champ Zone répétée.
Remarque : Il est conseillé d'utiliser la fonction ZoneRépétéeInsèreLigne. En effet, la fonction ZoneRépétéeInsèreLigne permet d'insérer :
  • des caractères TAB dans les attributs / champs.
  • des valeurs de n'importe quel type dans les attributs / champs.
WINDEVWINDEV Mobile Pour les champs Zone répétée sans attributs, il est conseillé d'utiliser la fonction ZoneRépétéeInsèreLigne.
Exemple
// Initialisation du champ Zone répétée ZR_REPETE1
ZoneRépétéeSupprimeTout(ZR_REPETE1)
HLitPremier(Produit, NomProd)
TANTQUE HEnDehors() = Faux
	ZoneRépétéeInsère(ZR_REPETE1, Produit.NomProd + TAB + Produit.Code)
	HLitSuivant(Produit, NomProd)
FIN
// Ajout de valeurs dans le champ Zone répétée en 12ème position
ZoneRépétéeInsère(ZR_Zone1, Nom+ TAB + Prénom + TAB + NumTel + TAB + NumFax, 12)
Syntaxe
<Résultat> = ZoneRépétéeInsère(<Champ Zone répétée> , <Valeur> [, <Indice>])
<Résultat> : Booléen
  • Vrai si l'ajout a réussi,
  • Faux dans le cas contraire.
<Champ Zone répétée> : Nom de champ
Nom du champ Zone répétée à manipuler.
Si ce paramètre est égal à chaîne vide (""), l'ajout sera effectué dans le champ Zone répétée en cours.
<Valeur> : Chaîne de caractères
Liste des valeurs à insérer dans la nouvelle répétition. Ce paramètre doit être de la forme :
<Valeur 1> + TAB + ... + <Valeur N>

Les différentes valeurs doivent être indiquées dans l'ordre des attributs (fenêtre de description du champ Zone répétée).
Pour ne pas spécifier de valeur pour un attribut, utilisez une chaîne vide ("") ou 0 (selon le type de l'attribut).
<Indice> : Entier optionnel
Indice de la répétition à partir duquel la répétition sera insérée.
  • Si ce paramètre n'est pas précisé ou égal à -1, l'insertion sera effectuée avant la répétition en cours. Si aucune répétition n'est sélectionnée, l'insertion sera effectuée à la fin du champ Zone répétée.
  • Si <Indice> est supérieur au nombre de répétitions, l'insertion sera effectuée à la fin du champ Zone répétée. Dans ce cas, la fonction ZoneRépétéeInsère est équivalente à la fonction ZoneRépétéeAjoute.
  • Si ce paramètre est égal à 0, l'insertion sera effectuée au début du champ Zone répétée.
Remarques

Conditions d'utilisation

La fonction ZoneRépétéeInsère peut être utilisée indifféremment sur :
  • un champ Zone répétée fichier,
  • un champ Zone répétée par programmation.
WEBDEV - Code Navigateur Cette fonction n'est pas disponible sur les champs Zone répétée linéaire. Cette fonction est disponible uniquement sur les champs Zone répétée en mode navigateur.
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Zone répétée en mode Ajax, les champs Zone répétée en mode classique et les champs Zone répétée linéaire.
PHP La fonction ZoneRépétéeInsère peut être utilisée uniquement sur un champ Zone répétée par programmation.

Caractéristiques de la répétition

Si une valeur correspond au résultat d'un calcul, mettez l'expression numérique entre parenthèses. Par exemple :
ZoneRépétéeInsère(ZR_ZoneCalcul, (53+29) + TAB + (83-21), 12)

Manipulation d'un mémo binaire

Pour insérer un mémo binaire dans un champ Zone répétée, utilisez la fonction ZoneRépétéeInsèreLigne.

Tri

La fonction ZoneRépétéeInsère ne tient pas compte du tri.
Composante : wd300obj.dll
Version minimum requise
  • Version 9
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