Partager via


Series.DataLabels Method (PowerPoint)

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: PowerPoint 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

Note

Although the following code applies to Microsoft Word, you can readily modify it to apply to PowerPoint.

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

Series Object Members