DataLabels DataLabels DataLabels Interface


A collection of all the DataLabel objects for the specified series. Each DataLabel object represents a data label for a point or trendline. For a series without definable points (such as an area series), the DataLabels collection contains a single data label.

public interface class DataLabels : System::Collections::IEnumerable
public interface DataLabels : System.Collections.IEnumerable
Public Interface DataLabels
Implements IEnumerable


Use the DataLabels(Object) method to return the DataLabels collection.

Use DataLabels(index), where index is the data-label index number, to return a single DataLabel object.


Application Application Application

Returns an Application object that represents the Microsoft Excel application. Read-only.

AutoScaleFont AutoScaleFont AutoScaleFont

True if the text in the object changes font size when the object size changes. The default value is True. Read/write Object.

AutoText AutoText AutoText

True if the object automatically generates appropriate text based on context. Read/write Boolean.

Border Border Border

Returns a Border object that represents the border of the object.

Count Count Count

Returns the number of objects in the collection. Read-only Integer.

Creator Creator Creator

Returns a 32-bit integer that indicates the application in which this object was created. If the object was created in Microsoft Excel, this property returns the string XCEL, which is equivalent to the hexadecimal number 5843454C. Read-only XlCreator.

Fill Fill Fill

Returns a FillFormat object for a specified shape or a ChartFillFormat object for a specified chart that contains fill formatting properties for the shape or chart. Read-only.

Font Font Font

Returns a Font object that represents the font of the specified object.

Format Format Format

Returns the ChartFormat object. Read-only.

HorizontalAlignment HorizontalAlignment HorizontalAlignment

Returns or sets the horizontal alignment for the specified object. Read/write Object.

Interior Interior Interior

Returns an Interior object that represents the interior of the specified object.

Name Name Name

Returns the name of the object. Read-only String.

NumberFormat NumberFormat NumberFormat

Returns or sets the format code for the object. Read/write String.

NumberFormatLinked NumberFormatLinked NumberFormatLinked

True if the number format is linked to the cells (so that the number format changes in the labels when it changes in the cells). Read/write Boolean.

NumberFormatLocal NumberFormatLocal NumberFormatLocal

Returns or sets the format code for the object as a string in the language of the user. Read/write Object.

Orientation Orientation Orientation

The text orientation. Can be an integer value from –90 to 90 degrees.

Parent Parent Parent

Returns the parent object for the specified object. Read-only.

Position Position Position

Returns or sets the position of the data label. Read/write XlDataLabelPosition.

ReadingOrder ReadingOrder ReadingOrder

Returns or sets the reading order for the specified object. Can be one of the following constants: xlRTL (right-to-left), xlLTR (left-to-right), or xlContext. Read/write Integer.

Separator Separator Separator

Sets or returns an Object representing the separator used for the data labels on a chart. Read/write.

Shadow Shadow Shadow

True if the font is a shadow font or if the object has a shadow. Read/write Boolean.

ShowBubbleSize ShowBubbleSize ShowBubbleSize

True to show the bubble size for the data labels on a chart. False to hide. Read/write Boolean.

ShowCategoryName ShowCategoryName ShowCategoryName

True to display the category name for the data labels on a chart. False to hide. Read/write Boolean.

ShowLegendKey ShowLegendKey ShowLegendKey

True if the data label legend key is visible. Read/write Boolean.

ShowPercentage ShowPercentage ShowPercentage

True to display the percentage value for the data labels on a chart. False to hide. Read/write Boolean.

ShowRange ShowRange ShowRange

Used to toggle the Range field if it exists on the data label range. Boolean (bool in C#) Read/Write

ShowSeriesName ShowSeriesName ShowSeriesName

Returns or sets a Boolean to indicate the series name display behavior for the data labels on a chart. True to show the series name. False to hide. Read/write.

ShowValue ShowValue ShowValue

Returns or sets a Boolean corresponding to a specified chart's data label values display behavior. True displays the values. False to hide. Read/write.

Type Type Type

Returns or sets the label type. Read/write Object.

VerticalAlignment VerticalAlignment VerticalAlignment

Returns or sets the vertical alignment of the specified object.


_Default(Object) _Default(Object) _Default(Object)

Reserved for internal use.

_Dummy10() _Dummy10() _Dummy10()

Reserved for internal use.

_Dummy13() _Dummy13() _Dummy13()

Reserved for internal use.

_Dummy16() _Dummy16() _Dummy16()

Reserved for internal use.

_Dummy17() _Dummy17() _Dummy17()

Reserved for internal use.

_Dummy9() _Dummy9() _Dummy9()

Reserved for internal use.

Delete() Delete() Delete()

Deletes the object.

GetEnumerator() GetEnumerator() GetEnumerator()
Item(Object) Item(Object) Item(Object)

Returns a single object from the collection.

Propagate(Object) Propagate(Object) Propagate(Object)

Enables you to take the contents and formatting of a single data label and apply it to every other data label on the series.

Select() Select() Select()

Selects the object.

Applies to