Ajoute une nouvelle fenêtre interne à la liste des fenêtres internes parcourue par un champ Fenêtre Interne.
Attention : Si une fenêtre interne est associée en édition au champ Fenêtre Interne, cette fenêtre interne sera remplacée par la fenêtre interne ajoutée avec la fonction FIListeAjoute.
FIListeAjoute(FI_ChampFenêtreInterne, FI_FenêtreInterne1)
Syntaxe
<Résultat> = FIListeAjoute(<Champ Fenêtre Interne> , <Fenêtre interne> [, <Paramètre 1> [... [, <Paramètre N>]]])
<Résultat> : Entier
- Indice de la fenêtre ajoutée,
- 0 en cas d'erreur. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Champ Fenêtre Interne> : Chaîne de caractères
Nom du champ Fenêtre Interne à manipuler.
<Fenêtre interne> : Nom de fenêtre
Nom de la fenêtre interne à associer au champ.
<Paramètre 1> : Type de la valeur envoyée à la fenêtre (optionnel)
Premier paramètre à passer à l'événement "Déclarations globales" de la fenêtre à ouvrir. Ce paramètre est passé par référence et il est considéré comme une variable globale à la fenêtre.
<Paramètre N> : Type de la valeur envoyée à la fenêtre (optionnel)
Nième paramètre à passer à l'événement "Déclarations globales" de la fenêtre à ouvrir. Ce paramètre est passé par référence et il est considéré comme une variable globale à la fenêtre.
Remarques
- Pour naviguer entre les différentes fenêtres internes ajoutées au champ, il est possible :
- Les fenêtres internes ajoutées sont numérotées de 1 à x, selon leur ordre d'ajout dans la liste.
- Si une fenêtre interne est supprimée avec la fonction FIListeSupprime, les fenêtres internes suivant la fenêtre supprimée sont renumérotées.
- Pour insérer une fenêtre interne dans la liste, utilisez la fonction FIListeInsère.
- Pour modifier la fenêtre interne actuellement affichée par le champ, utilisez la fonction ChangeFenêtreSource.
Cas d'un parcours sur un fichier de données ou sur une requête : Si cette fonction est utilisée, elle déclenchera une exception. - Paramètres passés à la fenêtre interne : Les paramètres sont récupérés dans l'événement de "Déclarations globales" de la fenêtre interne. Il suffit de saisir la ligne de code suivante au début du code de l'événement :
PROCEDURE <Nom de la fenêtre>(<Paramètre1> [, <Paramètre2> [, ...]])
Pour plus de détails, consultez Fenêtre paramétrée.
Composante : wd280obj.dll