Déroule :
- une rupture d'un champ Table précédemment enroulée. Les éléments de la rupture sont alors visibles dans le champ.
Rappel : En exécution, un noeud est déroulé lorsque le signe "-" précède le nom du noeud.
Syntaxe
Champ Table avec ruptures : Dérouler une rupture Masquer les détails
TableDéroule(<Champ Table> [, <Numéro de la ligne> [, <Nom de la rupture>]])
<Champ Table> : Nom de champ
Nom du champ Table à manipuler. Ce champ doit posséder une ou plusieurs ruptures. Dans le cas contraire, cette fonction n'a aucun effet.
<Numéro de la ligne> : Entier optionnel
Numéro de la ligne de la rupture à dérouler. Ce numéro doit correspondre soit au numéro de la ligne en cours, soit au numéro de la première ligne de la rupture à dérouler. Si ce paramètre n'est pas spécifié, la rupture de la ligne en cours est enroulée.
<Nom de la rupture> : Chaîne de caractères optionnelle
Nom de la rupture à dérouler. Ce paramètre doit être spécifié dans le cas de ruptures imbriquées. Il permet de définir la rupture qui sera déroulée. Par défaut, si des ruptures sont imbriquées, aucune rupture n'est déroulée.
Remarques
Conditions d'utilisation
La fonction
TableDéroule peut être utilisée sur :
- un champ Table par programmation.
- un champ Table fichier chargé en mémoire.
Cette fonction ne peut pas être utilisée sur les champs Table fichier (accès direct).
Branche à dérouler
La fonction
TableDéroule n'a aucun effet :
| |
| Champ Table hiérarchique | Champ Table avec ruptures |
- si la branche à enrouler est introuvable.
- si la branche à enrouler est une feuille.
- si la branche à enrouler est déjà enroulé.
| - si le champ Table n'a pas de ruptures.
- si le champ Table contient plusieurs ruptures, et si la rupture à dérouler n'est pas indiquée.
- si aucune ligne n'est sélectionnée dans le champ Table et si le paramètre <Numéro de la ligne> n'est pas spécifié.
|
Remarques pour les champs Table hiérarchique :
- Si le paramètre <Numéro de ligne> ou <Nom de la branche> correspond à la branche contenue dans la première ligne, toute la hiérarchie du champ Table hiérarchique est déroulée (équivalent à la fonction TableDérouleTout).
- Lors de l'appel à la fonction TableDéroule, si la branche spécifiée possède une procédure associée par la propriété AjouteFilsDifféré, cette procédure sera exécutée.
Bandeau de sélection
La fonction
TableDéroule ne modifie pas la position du bandeau de sélection.
Vitesse d'exécution pour les champs Table hiérarchique
La vitesse d'exécution de la syntaxe 1 est plus rapide que celle de la syntaxe 2.
Classification Métier / UI : Code UI
Composante : wd280obj.dll