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
  • Ajout d'une répétition vide
  • Caractéristiques de la répétition
  • Position de la répétition ajoutée
  • Manipulation d'un mémo binaire
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 répétition à la fin d'un champ Zone répétée.
Avertissement
Il est conseillé d'utiliser la fonction ZoneRépétéeAjouteLigne. En effet, la fonction ZoneRépétéeAjouteLigne permet d'ajouter :
  • des caractères TAB dans les attributs/champs.
  • des valeurs de n'importe quel type dans les attributs/champs.
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éeAjoute(ZR_REPETE1, Produit.NomProd + TAB + Produit.CodeProduit)
HLitSuivant(Produit, NomProd)
FIN
// Ajout d'une répétition vide
ZoneRépétéeAjoute(ZR_Zone1)
// Positionnement sur la répétition vide
Indice = ZoneRépétéeOccurrence(ZR_Zone1)
// Puis initialisation des attributs
ATT_AttributNom[Indice] = "Hobbes"
ATT_AttributPrénom[Indice] = "Samantha"
 
// Ou initialisation des champs
// ZR_Zone1[Indice].ChampNom = "Hobbes"
// ZR_Zone1[Indice].ChampPrénom = "Samantha"
Syntaxe

Ajouter une répétition dans un champ Zone répétée avec attributs Masquer les détails

<Résultat> = ZoneRépétéeAjoute(<Champ Zone répétée> [, <Valeur>])
<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 optionnelle
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 des attributs, utilisez une chaîne vide ("") ou 0 (selon le type de l'attribut).
Si ce paramètre correspond à une chaîne vide (""), une répétition vide sera ajoutée.
Etats et Requêtes

Ajouter une répétition dans un champ Zone répétée sans attributs Masquer les détails

<Résultat> = ZoneRépétéeAjoute(<Champ Zone répétée>)
<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.
Remarques

Conditions d'utilisation

La fonction ZoneRépétéeAjoute peut être utilisée indifféremment sur :
  • un champ Zone répétée fichier,
  • un champ Zone répétée par programmation.

Ajout d'une répétition vide

Après l'ajout d'une répétition vide, il est nécessaire d'initialiser chaque attribut ou chaque champ un à un.
Par exemple :
  • Cas d'un champ Zone répétée avec attributs :
    // Ajout d'une répétition vide
    ZoneRépétéeAjoute(ZR_Zone1)
     
    // Positionnement sur la répétition vide
    Indice = ZoneRépétéeOccurrence(ZR_Zone1)
    // Puis initialisation des attributs
    ATT_AttributNom[Indice] = "Hobbes"
    ATT_AttributPrénom[Indice] = "Samantha"
    ATT_AttributCouleurPrénom[Indice] = RougeClair
    ATT_AttributVisibleAdresse[Indice] = Faux
  • Cas d'un champ Zone répétée sans attributs :
    // Ajout d'une répétition vide
    ZoneRépétéeAjoute(ZR_Zone1)
     
    // Positionnement sur la répétition vide
    Indice = ZoneRépétéeOccurrence(ZR_Zone1)
    // Puis initialisation des champs
    ZR_Zone1[Indice].ChampNom = "Hobbes"
    ZR_Zone1[Indice].ChampPrénom = "Samantha"
    ZR_Zone1[Indice].ChampPrénom.CouleurFond = RougeClair
    ZR_Zone1[Indice].ChampAdresse.Visible = Faux

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éeAjoute(ZR_ZoneCalcul, (53+29) + TAB + (83-21))

Position de la répétition ajoutée

Par défaut, la répétition est ajoutée à la fin du champ Zone répétée.
Si le champ Zone répétée est trié (fonction ZoneRépétéeTrie), la répétition ajoutée est positionnée dans le champ Zone répétée en fonction du tri en cours.

Manipulation d'un mémo binaire

Pour ajouter un mémo binaire dans un champ Zone répétée, utilisez la fonction ZoneRépétéeAjouteLigne.
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