Cell.Formula, méthode (Word)

Insère dans une cellule de tableau un champ = (Formula) qui contient la formule spécifiée.

Syntaxe

expression. Formula (Formula, NumFormat)

expression Obligatoire. Variable qui représente un objet « Cell ».

Paramètres

Nom Requis/Facultatif Type de données Description
Formula Facultatif Variant Formule mathématique que le champ = (Formula) doit calculer. Les références de type tableur sont acceptées. Par exemple, la formule « =SUM(A4:C4) » additionne les trois premières valeurs de la quatrième ligne. Pour plus d'informations sur le champ = (Formula), voir Codes de champ : champ = (Formula).
NumFormat Facultatif Variant Format à appliquer à la valeur du champ = (Formula). Pour plus d'informations sur les types de formats pouvant être appliqués, voir Commutateur de champ d'image numérique (#).

Remarques

L'argument Formula est facultatif dans la mesure où il existe au moins une cellule qui contient une valeur au-dessus ou à gauche de la cellule qui contient le point d'insertion. Si les cellules situées au-dessus du point d'insertion contiennent des valeurs, le champ inséré est {= Sum (ABOVE)} ; Si les cellules situées à gauche de l'insertion de point contiennent des valeurs, le champ inséré est {= Sum (Left)}. Si des cellules situées au-dessus du point d'insertion et les cellules à gauche du point d'insertion contiennent des valeurs, Microsoft Word utilise les règles suivantes pour déterminer la fonction SUM à insérer :

  • Si la cellule située juste au-dessus du point d'insertion contient une valeur, Word insère {=SUM(ABOVE)}.

  • Si la cellule située immédiatement au-dessus du point d'insertion ne contient pas de valeur et que la cellule située immédiatement à gauche en contient une, Word insère {=SUM(LEFT)}.

  • Si aucune des deux cellules adjacentes ne contient de valeur, Word insère {=SUM(ABOVE)}.

  • Si vous ne spécifiez pas que Formula et si toutes les cellules situées au-dessus et à gauche du point d'insertion sont vides, la valeur du champ est une erreur.

Exemple

Cet exemple montre comment créer un tableau composé de trois lignes et trois colonnes au début du document actif, puis comment calculer la moyenne des nombres contenus dans la première colonne.

Set myRange = ActiveDocument.Range(0, 0) 
Set myTable = ActiveDocument.Tables.Add(myRange, 3, 3) 
With myTable 
 .Cell(1,1).Range.InsertAfter "100" 
 .Cell(2,1).Range.InsertAfter "50" 
 .Cell(3,1).Formula Formula:="=Average(Above)" 
End With

Cet exemple montre comment insérer au niveau du point d'insertion une formule qui détermine le nombre le plus élevé dans les cellules situées au-dessus de la cellule sélectionnée.

Selection.Collapse Direction:=wdCollapseStart 
If Selection.Information(wdWithInTable) = True Then 
 Selection.Cells(1).Formula Formula:="=Max(Above)" 
Else 
 MsgBox "The insertion point is not in a table." 
End If

Voir aussi

Objet Cell

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.