DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / Développer une application ou un site / Champs, fenêtres et pages / Champs : Types disponibles / Champ Zone Répétée
  • Présentation
  • Mode de sélection (onglet "UI" de la fenêtre de description)
  • Modes de sélection
  • Mode d'affichage (onglet "Détail" de la fenêtre de description)
  • Les différents modes disponibles
  • Mode standard vertical ou mode galerie en colonne : Ancrage des colonnes
  • Redimensionnement des cellules d'un champ Zone répétée
  • Autres paramètres de l'onglet "Détail"
  • Paramètres de saisie
  • Ascenseur
  • Déplacements et gestures
  • Champ de recherche
  • Pendant le remplissage d'un champ Zone répétée par programmation
  • Contenu de chaque ligne variable (Onglet "Contenu")
  • Mise en place
  • Caractéristiques des fenêtres internes
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
Présentation
Pour afficher les caractéristiques du champ, sélectionnez l'option "Description" dans le menu contextuel du champ. Dans une fenêtre, les attributs n'étant pas proposés par défaut, seules les caractéristiques du champ Zone répétée sont affichées.
Les caractéristiques importantes du champ sont regroupées dans les onglets suivants :
Mode de sélection (onglet "UI" de la fenêtre de description)

Modes de sélection

Dans un champ Zone répétée, les modes de sélection proposés sont les suivants :
  • Sans sélection : Le bandeau de sélection ne s'affiche pas sur la répétition (ou ligne) sélectionnée. Cependant, l'événement "Sélection d'une ligne" est exécuté lors de la sélection de la répétition (ligne).
  • Sélection simple : Le bandeau de sélection s'affiche sur la répétition (ligne) sélectionnée. Le code de 'événement "Sélection d'une ligne" est exécuté.
  • Sélection multiple : Le bandeau de sélection s'affiche sur les répétitions (lignes) sélectionnées. Pour sélectionner plusieurs répétitions (lignes), il suffit de maintenir la touche Maj ou Ctrl enfoncée. A chaque répétition (ligne) sélectionnée, l'événement "Sélection d'une ligne" est exécuté.
  • WINDEV Sélection multiple par simple clic : Cette option permet de réaliser une multisélection à la souris. Si cette option est sélectionnée, il suffit de cliquer sur une ligne pour que celle-ci soit ajoutée ou enlevée de la multisélection.
  • AndroidiPhone/iPad Mode de sélection Android/iOS : Cette option permet de masquer le bandeau de sélection après la sélection. Cela permet d'obtenir le fonctionnement standard sur ces plateformes : le bandeau apparaît uniquement lors de l'appui sur la ligne. Le code de sélection de ligne est ensuite exécuté.
Mode d'affichage (onglet "Détail" de la fenêtre de description)

Les différents modes disponibles

Plusieurs modes d'affichage sont disponibles :
  • Standard (grille) : Mode d'affichage correspondant au champ Zone répétée standard. Dans ce cas, le champ Zone répétée peut être horizontal ou vertical.
  • Galerie en ligne : Mode d'affichage correspondant au champ Galerie en ligne. Pour plus de détails, consultez Champ Zone répétée 'Galerie d'images'.
  • Galerie en colonne : Mode d'affichage correspondant au champ Galerie en colonne. Pour plus de détails, consultez Champ Zone répétée 'Galerie d'images'.
Ces modes sont choisis dans l'onglet "Détail" de la fenêtre de description du champ Zone répétée.

Mode standard vertical ou mode galerie en colonne : Ancrage des colonnes

Les options disponibles sont les suivantes :
  • Largeur de colonnes variable : Si la largeur de la zone répétée permet l'affichage d'une colonne supplémentaire, le nombre de colonnes n'est pas modifié. Seule la largeur des colonnes est modifiée.
  • Largeur et nombre de colonnes variables : Si la largeur de la zone répétée permet l'affichage d'une colonne supplémentaire, alors elle est ajoutée. Avant d'ajouter la colonne, les répétitions sont étirées horizontalement.
  • Nombre de colonnes variable (à gauche) : Si la largeur de la zone répétée permet l'affichage d'une colonne supplémentaire, alors elle est ajoutée. Avant d'ajouter la colonne, les colonnes sont alignées à gauche et une zone vide peut apparaître à droite.
  • Nombre de colonnes variable (centrées) : Si la largeur de la zone répétée permet l'affichage d'une colonne supplémentaire, alors elle est ajoutée. Avant d'ajouter une colonne, les colonnes sont centrées dans le champ et une zone vide peut apparaître de part et d'autre des colonnes centrées.
  • Largeur et nombre de colonnes fixes (à gauche) : Le nombre de colonnes et la largeur des colonnes ne sont pas modifiés. Les colonnes sont alignées à gauche.
  • Largeur et nombre de colonnes fixes (centrées) : Le nombre de colonnes et la largeur des colonnes ne sont pas modifiés. Les colonnes sont centrées.
Universal Windows 10 App Il n'est pas possible de sélectionner un mode d'affichage spécifique : les champs Zone répétée affichent uniquement une seule colonne.
WINDEVAndroidiPhone/iPad Mode standard horizontal : Ancrage des lignes
Plusieurs modes d'affichage sont disponibles :
  • Hauteur de lignes variable. Il suffit d'indiquer le nombre de lignes à afficher. La hauteur de chaque ligne évoluera en fonction de la hauteur du champ.
    Si la hauteur du champ est modifiée, la hauteur de chaque ligne augmentera ou diminuera de façon proportionnelle.
  • Hauteur et nombre de lignes variables. Si la hauteur du champ permet l'affichage d'une ligne supplémentaire, cette ligne sera ajoutée. Si cette ligne ne peut être ajoutée, la hauteur de la ligne sera modifiée. Il est nécessaire d'indiquer la hauteur de ligne minimale à afficher. Cette hauteur minimale sera utilisée pour chacune des lignes du champ Zone répétée.
  • Nombre de lignes variable (en haut). Il suffit d'indiquer la hauteur des lignes . Cette hauteur sera utilisée pour chacune des lignes du champ Zone répétée. Le nombre de lignes évoluera en fonction de la hauteur du champ.
    Lors de la modification de la hauteur du champ, le nombre de lignes augmentera ou diminuera. Si il n'est pas possible d'ajouter une ligne, une zone vide sera visible en bas de la zone répétée.
  • Nombre de lignes variable (centrées). Il suffit d'indiquer la hauteur des lignes. Cette hauteur sera utilisée pour chacune des lignes du champ Zone répétée. Le nombre de lignes évoluera en fonction de la hauteur du champ.
    Lors de la modification de la hauteur du champ, le nombre de lignes augmentera ou diminuera. Si il n'est pas possible d'ajouter une ligne, une zone vide sera visible de part et d'autre des répétitions.
  • Hauteur et nombre de lignes fixes (en haut) : Il suffit d'indiquer le nombre de lignes à afficher et la hauteur des lignes.
    Lors de la modification de la hauteur du champ, ni le nombre de lignes, ni la hauteur des lignes ne seront modifiés. Une zone vide apparaîtra en bas des colonnes.
    iPhone/iPad Cette option n'est pas disponible.
  • Hauteur et nombre de lignes fixes (centrées) : Il suffit d'indiquer le nombre de lignes à afficher et la hauteur des lignes.
    Lors de la modification de la hauteur du champ, ni le nombre de lignes, ni la hauteur des lignes ne seront modifiés. Une zone vide apparaîtra de part et d'autre des répétitions.
    iPhone/iPad Cette option n'est pas disponible.
Limitation : il n'est pas possible d'utiliser des ruptures dans un champ Zone répétée horizontale.
WINDEV

Redimensionnement des cellules d'un champ Zone répétée

Il est possible de permettre le redimensionnement des cellules d'un champ Zone répétée à l'utilisateur. Dans l'onglet "Détail" de la description du champ, il suffit de cocher l'option "Redimensionnable" présente devant les options suivantes :
  • "Hauteur de ligne".
  • "Largeur de colonne".
Remarque : La hauteur par défaut d'une ligne peut être spécifiée.
Autres paramètres de l'onglet "Détail"
WINDEVUniversal Windows 10 App

Paramètres de saisie

Les paramètres de saisie permettent de spécifier le comportement des champs Zone répétée fichier en saisie. Les options possibles sont les suivantes :
  • Saisie en cascade : L'utilisation de la touche Entrée dans un champ de saisie permet de saisir automatiquement une nouvelle répétition.
    Universal Windows 10 App Cette option n'est pas disponible.
  • Enregistrer en sortie de ligne ou Enregistrer en sortie de colonne : L'enregistrement en cours de modification ou de création sera automatiquement sauvegardé dans le fichier de données correspondant dès que la répétition ne sera plus sélectionnée. Si cette option n'est pas sélectionnée, la sauvegarde de l'enregistrement doit être programmée avec la fonction ZoneRépétéeEnregistre.
  • Blocage enregistrement en modification : Lors de la modification d'une répétition, l'enregistrement correspondant dans le fichier de données sera automatiquement bloqué jusqu'à la validation de la modification.
WINDEVUniversal Windows 10 App

Ascenseur

L'affichage de l'ascenseur horizontal/vertical peut être :
  • automatique : l'ascenseur sera affiché uniquement en cas de besoin.
  • toujours visible : l'ascenseur sera toujours affiché.
  • jamais visible : l'ascenseur ne sera jamais affiché.
Il est possible d'afficher ou non une bulle d'aide sur l'ascenseur vertical. Cette bulle d'aide affiche le numéro de la répétition en cours par rapport au nombre total de répétitions.
Universal Windows 10 App Cette option n'est pas disponible.

Déplacements et gestures

Les options suivantes sont disponibles :
  • Scroll au pixel : selon la position de l'ascenseur, une répétition peut ne pas être affichée complètement.
  • Scroll au doigt : permet de manipuler l'ascenseur par un écran tactile.
AndroidiPhone/iPad Des options spécifiques de déplacements et gestures peuvent également être définies. Pour plus de détails, consultez Zone répétée : Déplacements et gestures.
WINDEVUniversal Windows 10 App

Champ de recherche

Le champ Zone Répétée peut proposer d'effectuer une recherche dans les données affichées. Les options proposées sont :
  • En utilisant le menu des F.A.A. : La recherche sera effectuées via l'option "Rechercher" du menu des FAA (Fonctionnalités automatiques de votre application).
  • Toujours visible : un champ de recherche sera toujours affiché au dessus du champ Zone répétée.
  • Jamais : Aucune recherche ne pourra être effectuée dans le champ Zone Répétée.
Windows

Pendant le remplissage d'un champ Zone répétée par programmation

Pendant le remplissage d'un champ Zone répétée manipulée par programmation, il est possible d'afficher des informations spécifiques :
  • Jauge de progression,
  • Fenêtre d'information, ...
Pour afficher une information pendant le remplissage d'un champ Zone répétée par programmation :
  1. Affichez la fenêtre de description du champ Zone répétée.
  2. Dans l'onglet "Détail" de la fenêtre de description du champ, cochez l'option "Afficher une Fenêtre interne par dessus les lignes".
  3. Spécifiez si nécessaire la fenêtre interne à utiliser. Il est possible de :
    • utiliser la fenêtre proposée par défaut par WINDEV (option "Aucune").
    • importer dans le projet la fenêtre prédéfinie proposée par WINDEV pour la personnaliser (option "Fenêtre prédéfinie").
      Si cette option est sélectionnée, le composant interne WDFAA est immédiatement ajouté dans le projet en cours. La fenêtre interne "FI_EtatChargementTable" est associée à la fonctionnalité.
      Remarque : Si le composant WDFAA existe déjà, seule la fenêtre est ajoutée au composant.
  4. Validez si nécessaire la fenêtre de description du champ.
  5. Pour activer ce mécanisme, utilisez les fonctions ZoneRépétéeDébutRemplissage et ZoneRépétéeFinRemplissage pour entourer le code de remplissage du champ Zone répétée.
Remarques :
  • Par défaut, le message "Aucune donnée disponible" est affiché dans le champ Zone répétée vide. Lors du remplissage, une jauge infinie est affichée en bas du champ Zone répétée.
  • La fenêtre interne proposée par défaut contient 3 plans :
    • Plan 1 contenant une jauge infinie.
    • Plan 2 contenant le libellé affiché si le champ Zone répétée est vide. Le libellé affiché par défaut est "Aucune donnée disponible".
    • Plan 3 contenant le libellé affiché avant l'appel de la fonction ZoneRépétéeDébutRemplissage.
  • La fenêtre interne "FI_EtatChargementTable" est également utilisée pour gérer le remplissage des champs Table par programmation.
Contenu de chaque ligne variable (Onglet "Contenu")
Les champs Zone répétée offrent la possibilité de personnaliser totalement l'apparence des répétitions : mise en page, contenu, ... Il est ainsi possible par exemple d'imbriquer des zones répétées dans des zones répétées.

Mise en place

Pour créer un champ Zone répétée avec un contenu variable :
  1. Créez un champ Zone répétée rempli par programmation. Ce champ doit être un champ Zone répétée verticale constitué d'une seule colonne.
  2. Affichez la fenêtre de description du champ Zone répétée.
  3. Dans l'onglet "Contenu" de la description du champ :
    • Cochez l'option "Utiliser une Fenêtre interne par ligne (fonction ZoneRépétéeAjouteFI)".
    • Indiquez le mode de déchargement des fenêtres internes :
      • Jamais : Le chargement des fenêtres internes est effectué quand la répétition associée est visible dans le champ. Le déchargement n'est jamais effectué lors de la manipulation du champ. Il est uniquement effectué à la fermeture de la fenêtre. Ce mode est conseillé si les fenêtres internes sont peu nombreuses et contiennent peu de champs.
        Avantage : Toutes les données sont toujours disponibles
        Inconvénient : Consommation mémoire importante.
      • Lorsque la ligne n'est plus visible (option sélectionnée par défaut) : Le chargement des fenêtres internes est effectué quand la répétition associée est visible dans le champ. Le déchargement est effectué lorsque la ligne n'est plus visible. Ce mode est conseillé pour les champs Zone répétée ne permettant pas de saisie. En effet, si une fenêtre interne permet une saisie, lorsque cette fenêtre interne n'est plus visible, le contenu saisi par l'utilisateur est perdu.
        Avantage : Consomme peu de mémoire.
        Inconvénient : Perte des informations saisies par l'utilisateur.
      • Ligne non visible + FI ne contenant que des champs d'affichage : Le chargement des fenêtres internes est effectué quand la répétition associée est visible dans le champ. Le déchargement est effectué en fonction du type de la ligne :
        • Si la ligne ne contient pas de champs permettant la saisie par l'utilisateur, la fenêtre interne associée est déchargée lorsqu'elle n'est plus visible.
        • Si la ligne permet une saisie, la fenêtre interne associée n'est jamais déchargée.
  4. Validez la fenêtre de description du champ.
  5. Créez les différentes fenêtres internes correspondant aux lignes / répétitions du champ Zone répétée.
  6. Ajoutez les fenêtres internes dans le champ Zone répétée grâce aux fonctions suivantes :
    ZoneRépétéeAjouteFIAjoute une répétition sous forme d'une fenêtre interne à la fin d'un champ Zone répétée par programmation.
    ZoneRépétéeInsèreFIInsère une répétition sous forme d'une fenêtre interne dans un champ Zone répétée par programmation.
    ZoneRépétéeModifieFIModifie une répétition correspondant à une fenêtre interne dans un champ Zone répétée par programmation.

Caractéristiques des fenêtres internes

Les caractéristiques de largeur et de hauteur des fenêtres internes sont les suivantes :
  • Hauteur : La hauteur de la répétition utilisant une fenêtre interne correspond exactement à la hauteur de la fenêtre interne définie en édition. La fenêtre interne ne peut pas être plus haute que le champ Zone répétée.
  • Largeur :
    • Si la largeur de la fenêtre interne est plus petite que celle du champ Zone répétée, la largeur de la fenêtre interne est automatiquement augmentée et les ancrages sont appliqués.
    • Si la largeur de la fenêtre interne est plus grande que celle du champ Zone répétée, la fenêtre interne est automatiquement tronquée.
    En règle générale, il est conseillé de réaliser la fenêtre interne avec la plus petite largeur possible et d'utiliser les ancrages.
Remarque : Si la fenêtre interne possède des champs adaptés au contenu, la hauteur de la répétition sera augmentée ou diminuée en fonction du contenu.
Liste des exemples associés :
Le champ Zone répétée Exemples unitaires (WINDEV) : Le champ Zone répétée
[ + ] Utilisation du champ Zone répétée.
Il est possible d'ajouter une ligne grâce à la fonction ZoneRépétéeAjouteLigne.
Il est également possible de récupérer les valeurs saisies grâce à la syntaxe :
  NomAttribut[Indice]
WM Gestion Contacts Exemples multiplateforme (WINDEV Mobile) : WM Gestion Contacts
[ + ] Cet exemple illustre la gestion de contacts pour Android et iOS.
Il permet de :
- lister les contacts du téléphone
- appeler les contacts
- envoyer des sms aux contacts
- ...
WM Inscrits Exemples multiplateforme (WINDEV Mobile) : WM Inscrits
[ + ] Cette application est un gestionnaire de présence. Elle permet de noter les personnes présentes lors d'un séminaire.
La base de données est préalablement renseignée avec la liste des personnes inscrites.
Il est possible de rechercher une personne par son nom.
Dans cet exemple, nous abordons les principaux thèmes suivants :
1/ l'utilisation d'une zone répétée fichier basée sur une requête
2/ l'utilisation d'une base de données au format HFSQL.
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/04/2023

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