Share via


Series.DataLabels Method (Word)

Returns an object that represents either a single data label (a DataLabel object) or a collection of all the data labels for the series (a DataLabels collection).

Version Information

Version Added: Word 2007

Syntax

expression .DataLabels(Index)

expression A variable that represents a Series object.

Parameters

Name

Required/Optional

Data Type

Description

Index

Optional

Variant

The number of the data label.

Return Value

An object that represents either a single data label (a DataLabel object) or a collection of all the data labels for the series (a DataLabels collection).

Remarks

If the series has the Show Value option turned on for the data labels, the returned collection can contain up to one label for each point. Data labels can be turned on or off for individual points in the series.

If the series is on an area chart and has the Show Label option turned on for the data labels, the returned collection contains only a single label, which is the label for the area series.

Example

The following example sets the data labels for series one for the first chart in the active document to show their key, assuming that their values are visible when the example runs.

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 With .Chart.SeriesCollection(1) 
 .HasDataLabels = True 
 With .DataLabels 
 .ShowLegendKey = True 
 .Type = xlValue 
 End With 
 End With 
 End If 
End With

See Also

Concepts

Series Object Members

Series Object