Selection.InsertFormula(Object, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Interop.Word

Assembly:: Microsoft.Office.Interop.Word.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Inserts an = (Formula) field that contains a formula at the selection.

public void InsertFormula (ref object Formula, ref object NumberFormat);

abstract member InsertFormula : obj * obj -> unit

Public Sub InsertFormula (Optional ByRef Formula As Object, Optional ByRef NumberFormat As Object)

Parameters

Formula: Object

Optional Object. The mathematical formula you want the = (Formula) field to evaluate. Spreadsheet-type references to table cells are valid. For example, "=SUM(A4:C4)" specifies the first three values in the fourth row.

NumberFormat: Object

Optional Object. A format for the result of the = (Formula) field.

Remarks

The formula replaces the selection, if the selection isn't collapsed.

If you're using a spreadsheet application, such as Microsoft Excel, embedding all or part of a worksheet in a document is often easier than using the = (Formula) field in a table.

The Formula argument is optional only if the selection is in a cell and there's at least one cell that contains a value above or to the left of the cell that contains the insertion point. If the cells above the insertion point contain values, the inserted field is {=SUM(ABOVE)}; if the cells to the left of the insertion point contain values, the inserted field is {=SUM(LEFT)}. If both the cells above the insertion point and the cells to the left of it contain values, Microsoft Word uses the following rules to determine which SUM function to insert:

Applies to