Arguments de références de ligne, de colonne ou de cellule

L'argument de ligne, de colonne ou de cellule identifie une ligne, une colonne ou une cellule d'une grille. Syntaxe :

FunctionName(GridName.GridElement[segment(range)].Property)

Tableau B-3 Composants d'un argument

Argument Description

GridName

Nom du formulaire. Par exemple :

La différence (grille1.row[5], grille1.row[6]) renvoie la différence entre deux lignes situées dans la grille 1 du formulaire.

Facultatif. Si GridName n'est pas indiqué, le nom par défaut est celui du formulaire actuel.

GridElement

L'un des mots-clés suivants : row, col, column ou cell.

Par exemple, Max(row[1], row[2], row[3]) renvoie la valeur maximale des trois lignes. GridElement est facultatif. Cependant, une référence de cellule (cell) requiert des identifiants de segment de ligne et de colonne. Par exemple, cell[2, A] et [2, A] se réfèrent à la cellule située à l'intersection de la ligne 2 et de la colonne A. Le mot-clé cell est facultatif. Les références de la cellule peuvent utiliser la syntaxe [row, col] ou la syntaxe [col, row].

Facultatif. Si GridElement n'est pas spécifié, les lettres représentent les colonnes et les chiffres représentent les lignes. Par exemple, Max ([1, A], [2, A], [3, A]) fait référence aux lignes 1, 2 et 3 de la colonne A.

segment

Numéro de référence de ligne, de colonne ou de cellule. Pour une colonne ou une ligne développée, vous devez spécifier le segment. Par exemple, row[2] désigne le segment de ligne 2. Les segments sont mis entre crochets [ ].

Obligatoire.

range

Lignes, colonnes ou cellules développées à partir du segment spécifié. Si une plage est spécifiée, le système calcule la formule en utilisant uniquement la plage indiquée. Par exemple, row[2(3:5)] utilise uniquement la plage comprise entre la troisième ligne et la cinquième ligne du segment développé 2.

Facultatif. Si aucune plage n'est spécifiée, toutes les cellules développées sont utilisées.

Remarque :

Si un segment ne se déploie qu'à une ligne ou colonne, n'utilisez pas l'argument plage.

property

L'un des mots-clés suivants : average, averageA, count, countA, max, min, product ou sum. La propriété indique comment agréger les lignes, colonnes ou cellules développées spécifiées.

Il est recommandé de ne pas spécifier de propriété lorsqu'une référence est un argument. Dans ce cas, la fonction calcule la référence de la façon la plus appropriée. Par exemple, l'expression suivante renvoie la moyenne des cellules des lignes 1 et 2 :

Average(row[1], row[2])

Tandis que l'exemple ci-dessous calcule d'abord la moyenne de la ligne 1 (row[1]), puis celle de la ligne 2 (row[2]), et ajoute ensuite ces deux résultats avant de diviser par 2 :

Average(row[1].average, row[2].average)

La propriété par défaut pour une référence de ligne, de colonne ou de cellule est sum. Par exemple, row[2] est équivalent à Sum(row[2]).

Le segment étant la seule partie obligatoire d'une référence, les références suivantes sont identiques :

Grid1.row[1].sum
[1]

AverageA et CountA tiennent compte des cellules #MISSING dans leur calcul. Par exemple, si la ligne 1 est une ligne de segment qui se développe en Qdr1 = 100, Qdr2 = 200, Qdr3 = #MISSING et Qdr4 = 400, la fonction suivante renvoie la valeur quatre (4) :

row[1].CountA

Toutes les autres fonctions excluent les cellules #MISSING. Ainsi, l'exemple précédent de la ligne 1 qui se développe en Qdr1 = 100, Qdr2 = 200, Qdr3 = #MISSING et Qdr4 = 400 renvoie la valeur trois (3) dans cet exemple :

row[1].Count