|
|
|
|
|
- Ajout d'une ligne dans un tableau WLangage
- Ajout d'une ligne dans une propriété tableau d'un type avancé
- Divers
<Tableau>.AjouteLigne (Fonction) En anglais : <Array>.AddLine Ajoute une ligne à la fin : - d'un tableau WLangage à une ou deux dimensions.
- d'une propriété tableau d'un type avancé à deux dimensions (xlsDocument, ...).
MonTableau est un tableau de 2 par 3 chaînes MonTableau.AjouteLigne("A", "B", "C") MonTableau.AjouteLigne("a", "b", "c") MonTableau.AjouteLigne("D", "E", "F") // Afficher le contenu de la 3° ligne (les deux premières sont vides) Trace(MonTableau[3,1], MonTableau[3,2], MonTableau[3,3]) // Affiche "A B C" MonTableau est un tableau de 2 par 3 chaînes MonTableau[1,1] = "A" MonTableau[1,2] = "B" MonTableau[1,3] = "C" MonTableau[2,1] = "a" MonTableau[2,2] = "b" MonTableau[2,3] = "c" MonTableau.AjouteLigne("D", "E", "F") // Afficher le contenu de la 3° ligne Trace(MonTableau[3,1], MonTableau[3,2], MonTableau[3,3]) // Affiche "D E F" Syntaxe
<Résultat> = <Tableau WLangage>.AjouteLigne([<Élément colonne 1> [... [, <Élément colonne N>]]])
<Résultat> : Entier - Indice de la ligne ajoutée,
- -1 en cas d'erreur.
<Tableau WLangage> : Tableau Nom de la variable de type Tableau à manipuler. Ce tableau doit être un tableau à une ou deux dimensions. <Élément colonne 1> : Type des éléments du tableau, optionnel Élément de la ligne à ajouter dans le tableau spécifié. Chaque élément correspond à une colonne dans le tableau. Le type de l'élément ajouté doit être compatible avec le type de la colonne concernée. Si aucun de ces paramètres n'est spécifié, une ligne vide est ajoutée dans le tableau. Les colonnes sont initialisées avec la valeur par défaut du type des autres éléments du tableau. Si un de ces paramètres n'est pas spécifié, la colonne correspondante est initialisée avec la valeur par défaut du type des autres éléments du tableau. <Élément colonne N> : Type des éléments du tableau, optionnel Élément de la ligne à ajouter dans le tableau spécifié. Chaque élément correspond à une colonne dans le tableau. Le type de l'élément ajouté doit être compatible avec le type de la colonne concernée. Si aucun de ces paramètres n'est spécifié, une ligne vide est ajoutée dans le tableau. Les colonnes sont initialisées avec la valeur par défaut du type des autres éléments du tableau. Si un de ces paramètres n'est pas spécifié, la colonne correspondante est initialisée avec la valeur par défaut du type des autres éléments du tableau. Remarques Ajout d'une ligne dans un tableau WLangage Lors de l'utilisation de la fonction <Tableau>.AjouteLigne : - le nombre de lignes du tableau est automatiquement agrandi pour accueillir la nouvelle ligne.
- le nombre de colonnes du tableau n'est pas agrandi. Il est donc nécessaire :
- soit de déclarer le tableau avec le bon nombre de colonnes (deuxième dimension du tableau).
- soit de modifier dynamiquement le nombre de colonnes avec la fonction Dimension.
- les éléments sont convertis si nécessaire dans le type des autres éléments du tableau.
Remarque : Lors de la déclaration d'un tableau de N par M éléments, ce tableau contient N lignes vides. Par exemple, le tableau déclaré ci-dessous contient 3 lignes vides.
MonTableau est un tableau de 3 par 2 chaînes Lors de l'ajout d'une ligne (fonction <Tableau>.AjouteLigne), cette ligne est automatiquement ajoutée à la suite des lignes déjà présentes dans le tableau. Dans notre exemple, la ligne ajoutée correspondra à la 4° ligne. Ajout d'une ligne dans une propriété tableau d'un type avancé Lors de l'utilisation de la fonction <Tableau>.AjouteLigne : - la variable de type avancé doit être allouée.
- le type avancé doit avoir un énumérateur de type collection modifiable.
- le type avancé est automatiquement agrandi pour accueillir la nouvelle ligne.
Divers - Cette fonction ne peut pas être utilisée sur :
- les tableaux non alloués.
- les tableaux fixes.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|