Selection.InsertFormula, méthode (Word)

  • Article

Insère dans la sélection un champ = (Formula) qui contient une formule.

Syntaxe

expression. Formule (Formula, NumberFormat)

expression Obligatoire. Variable qui représente un objet Selection.

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).
NumberFormat Facultatif Variant Format à appliquer à la valeur du champ = (Formula). Pour plus d’informations sur les types de formats que vous pouvez appliquer, consultez Commutateur de champ Image numérique (#).

Remarques

Si la sélection n'est pas réduite, la formule la remplace.

Si vous utilisez un tableur tel que Microsoft Office Excel, incorporer tout ou partie d'une feuille de calcul dans un document est souvent plus aisé qu'utiliser le champ = (Formula) dans un tableau.

L’argument Formule n’est facultatif que si la sélection se trouve dans une cellule et qu’au moins une cellule 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 les cellules situées au-dessus du point d’insertion et les cellules situées à gauche de celui-ci contiennent des valeurs, Microsoft Word utilise les règles suivantes pour déterminer la fonction SOMME à 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 juste au-dessus du point d'insertion ne contient pas de valeur, à l'inverse de celle située à sa gauche, Word insère {=SUM(LEFT)}.

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

  • Si vous ne spécifiez pas l'argument Formula et si toutes les cellules situées au-dessus et à gauche du point d'insertion sont vides, l'emploi du champ = (Formula) provoque une erreur.

Exemple

Cet exemple montre comment créer un tableau de trois lignes sur trois colonnes au début du document actif, puis comment calculer la moyenne des valeurs contenues 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).Select 
End With 
Selection.InsertFormula Formula:="=Average(Above)"

L'exemple montre comment insérer un champ de type formule qui effectue une soustraction à partir d'une valeur représentée par le signet « GrossSales ». Le résultat est mis en forme avec le signe dollar.

Selection.Collapse Direction:=wdCollapseStart 
Selection.InsertFormula Formula:= "=GrossSales-45,000.00", _ 
 NumberFormat:="$#,##0.00"

Voir aussi

Selection, objet

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.