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 <Zone répétée>.AjouteLigne. En effet, la fonction <Zone répétée>.AjouteLigne 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 
ZR_REPETE1.SupprimeTout() 
HLitPremier(Produit, NomProd) 
TANTQUE HEnDehors() = Faux
ZR_REPETE1.Ajoute(Produit.NomProd + TAB + Produit.CodeProduit) 
HLitSuivant(Produit, NomProd) 
FIN
// Ajout d'une répétition vide 
ZR_Zone1.Ajoute() 
// Positionnement sur la répétition vide 
Indice = ZR_Zone1.Occurrence() 
// 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> = <Champ Zone répétée>.Ajoute([<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.
<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.
WINDEVEtats et RequêtesUniversal Windows 10 AppAndroidiPhone/iPadJavaCode Utilisateur (MCU)

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

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

Conditions d'utilisation

La fonction <Zone répétée>.Ajoute 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 <Zone répétée>.Ajoute peut être utilisée uniquement sur 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
    ZR_Zone1.Ajoute()

    // Positionnement sur la répétition vide
    Indice = ZR_Zone1.Occurrence()
    // 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
    ZR_Zone1.Ajoute()
     
    // Positionnement sur la répétition vide
    Indice = ZR_Zone1.Occurrence()
    // 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 :
ZR_ZoneCalcul.Ajoute((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 <Zone répétée>.Trie), 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 <Zone répétée>.AjouteLigne.
Composante : wd290obj.dll
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