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
  • 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 : Pour ajouter des éléments à la fin d'un champ Zone répétée, utilisez la fonction ZoneRépétéeAjouteLigne.
Exemple
// Ajout de valeurs dans le champ Zone répétée en 12ème position
ZoneRépétéeInsèreLigne(ZR_Zone1, 12, Nom, Prénom, NumTel, NumFax)
// Insertion d'informations recherchées dans la base de données
i est un entier = 1
ZoneRépétéeSupprimeTout(ZR_REPETE1)
HLitRecherche(Produit, NomProd, "Fenêtre")
TANTQUE HEnDehors() = Faux
ZoneRépétéeInsèreLigne(ZR_REPETE1, i, Produit.NomProd, Produit.Code)
HLitSuivant(Produit, NomProd)
i ++
FIN
Syntaxe

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

ZoneRépétéeInsèreLigne(<Champ Zone répétée> [, <Indice> [, <Valeur 1> [, <Valeur N>]]])
<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'insertion sera effectuée sur le champ Zone répétée en cours
<Indice> : Entier optionnel
Indice de la répétition à partir duquel la répétition sera insérée.
Indice non préciséLa répétition est insérée avant la répétition en cours. Si aucune répétition n'est sélectionnée, la répétition est insérée à la fin du champ Zone répétée.
Indice supérieur au nombre de répétitions du champLa répétition est insérée à la fin du champ Zone répétée. Dans ce cas, la fonction ZoneRépétéeInsèreLigne est équivalente à la fonction ZoneRépétéeAjouteLigne.
Indice égal à 0La répétition est insérée au début du champ Zone répétée.
Indice égal à -1La répétition est insérée avant la répétition en cours. Si aucune répétition n'est sélectionnée, la répétition est insérée à la fin du champ Zone répétée.
<Valeur 1> : Type de l'attribut associé (optionnel)
Valeur du 1er attribut de la répétition à insérer dans le champ Zone répétée spécifié.
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 aucun des ces paramètres n'est spécifié, une répétition vide est insérée dans le champ Zone répétée.
<Valeur N> : Type de l'attribut associé (optionnel)
Valeur du Nième attribut de la répétition à insérer dans le champ Zone répétée spécifié.
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 aucun des ces paramètres n'est spécifié, une répétition vide est insérée dans le champ Zone répétée.
WINDEVEtats et RequêtesUniversal Windows 10 AppAndroidiPhone/iPadJavaCode Utilisateur (MCU)

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

ZoneRépétéeInsèreLigne(<Champ Zone répétée> [, <Indice>])
<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'insertion sera effectuée sur le champ Zone répétée en cours.
<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èreLigne est équivalente à la fonction ZoneRépétéeAjouteLigne.
  • 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èreLigne 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èreLigne peut être utilisée uniquement sur un champ Zone répétée mémoire.

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éeInsèreLigne(ZR_Zone1, 14)
     
    // Puis initialisation des attributs
    AttributNom[14] = "Hobbes"
    AttributPrénom[14] = "Samantha"
    AttributCouleurPrénom[14] = RougeClair
    AttributVisibleAdresse[14] = Faux
  • Cas d'un champ Zone répétée sans attributs :
    // Ajout d'une répétition vide
    ZoneRépétéeInsèreLigne(ZR_Zone1, 14)
     
    // Puis initialisation des champs
    ZR_Zone1[14].ChampNom = "Hobbes"
    ZR_Zone1[14].ChampPrénom = "Samantha"
    ZR_Zone1[14].ChampPrénom.CouleurFond = RougeClair
    ZR_Zone1[14].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éeInsèreLigne(ZR_ZoneCalcul, 10, (53+29), (83-21))

Tri

La fonction ZoneRépétéeInsèreLigne ne tient pas compte du tri.
Composante : wd290obj.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