Trendlines.Add Method (Word)

Creates a new trendline.

Version Information

Version Added: Word 2007

Syntax

expression .Add(Type, Order, Period, Forward, Backward, Intercept, DisplayEquation, DisplayRSquared, Name)

expression A variable that represents a Trendlines object.

Parameters

Name	Required/Optional	Data Type	Description
Type	Optional	XlTrendlineType	One of the enumeration values that specifies the trendline type. The default is xlLinear.
Order	Optional	Variant	The trendline order. Required ifType is set to xlPolynomial. If specified, the value must be an integer from 2 through 6.
Period	Optional	Variant	The trendline period. Required ifType is set to xlMovingAvg. If specified, the value must be an integer greater than 1 and less than the number of data points in the series to which you are adding a trendline.
Forward	Optional	Variant	The number of periods (or units on a scatter chart) that the trendline extends forward.
Backward	Optional	Variant	The number of periods (or units on a scatter chart) that the trendline extends backward.
Intercept	Optional	Variant	The trendline intercept. If specified, the value must be a double-precision floating-point number. If omitted, the intercept is automatically set by the regression, and the InterceptIsAuto property of the resulting Trendline object is set to True. Note This parameter is applicable only ifType is set to xlExponential, xlLinear, or xlPolynomial.
DisplayEquation	Optional	Variant	True to display the equation of the trendline on the chart (in the same data label as the R-squared value). The default is False.
DisplayRSquared	Optional	Variant	True to display the R-squared value of the trendline on the chart (in the same data label as the equation). The default is False.
Name	Optional	Variant	The name of the trendline. If omitted, Microsoft Word generates a name, and the NameIsAuto property of the resulting Trendline object is set to True.

Return Value

A Trendline object that represents the new trendline.

Example

The following example creates a new linear trendline for the first chart in the active document.

With ActiveDocument.InlineShapes(1) 
    If .HasChart Then 
        .Chart.SeriesCollection(1).Trendlines.Add 
    End If 
End With

See Also

Concepts

Trendlines Object Members

Trendlines Object