Cell.Formula(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 the specified formula into a table cell.

public void Formula (ref object Formula, ref object NumFormat);

abstract member Formula : obj * obj -> unit

Public Sub Formula (Optional ByRef Formula As Object, Optional ByRef NumFormat As Object)

Parameters

Formula: 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.

NumFormat: Object

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

Remarks

Formula is optional as long as there is 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 the insertion point contain values, Microsoft Word uses the following rules to determine which SUM function to insert:

If the cell immediately above the insertion point contains a value, Word inserts {=SUM(ABOVE)}.

If the cell immediately above the insertion point doesn't contain a value and the cell immediately to the left of it does, Word inserts {=SUM(LEFT)}.

If neither adjoining cell contains a value, Word inserts {=SUM(ABOVE)}.

If you don't specify Formula and all the cells above and to the left of the insertion point are empty, the result of the field is an error.

Applies to

Share via