DataLabel Interface

Definition

Represents the data label on a chart point or trendline.

public interface class DataLabel
[System.Runtime.InteropServices.Guid("1FD94DF1-3569-4465-94FF-E8B22D28EEB0")]
public interface DataLabel
type DataLabel = interface
Public Interface DataLabel
Attributes

Remarks

On a series, the DataLabel object is a member of the DataLabels collection. The DataLabels collection contains a DataLabel object for each point. For a series without definable points (such as an area series), the DataLabels collection contains a single DataLabel object.

Properties

_Height
_Width
Application

When used without an object qualifier, this property returns an _Application object that represents the Microsoft Word application. When used with an object qualifier, this property returns an Application object that represents the creator of the specified object (you can use this property with an OLE Automation object to return the application of that object). Read-only.

AutoScaleFont

True if the text in the object changes font size when the object size changes. The default value is True.

AutoText

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

Border

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

Caption

Returns or sets a String value that represents the data label text.

Characters[Object, Object]

Returns a ChartCharacters object that represents a range of characters within the object text. You can use the ChartCharacters object to format characters within a text string.

Creator

Returns a 32-bit integer that indicates the application in which the specified object was created. Read-only Integer.

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

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

Format

Returns the line, fill, and effect formatting for the object. Read-only ChartFormat.

Formula

Gets or sets a value that represents the formula of the object using A1-style notation, in English.

FormulaLocal

Gets or sets the formula for the object, using A1-style references in the language of the user.

FormulaR1C1

Gets or sets the formula for the object, using R1C1-style notation in the language of the macro.

FormulaR1C1Local

Gets or sets the formula for the object, using R1C1-style notation in the language of the user.

Height

Gets the height, in points, of the object.

HorizontalAlignment

Returns or sets a Object value that represents the horizontal alignment for the specified object.

Interior

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

Left

Returns or sets a Double value that represents the distance, in points, from the left edge of the object to the left edge of the chart area.

Name

Returns a String value that represents the name of the object.

NumberFormat

Returns or sets a String value that represents the format code for the object.

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

Returns or sets an Object value that represents the format code for the object as a string in the language of the user.

Orientation

Returns or sets an Integer value that represents the text orientation.

Parent

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

Position

Returns or sets a XlDataLabelPosition value that represents the position of the data label.

ReadingOrder

Returns or sets an Integer corresponding to one of the XlReadingOrder constant that represents the reading order for the specified object. Read/write

Separator

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

Shadow

Returns or sets a Boolean value that determines if the object has a shadow.

ShowBubbleSize

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

ShowCategoryName

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

ShowLegendKey

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

ShowPercentage

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

ShowRange

Set to True to display the Value From Cells range field for the specified chart data label. Set to False to hide that field. Read/write Boolean (bool in C#).

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

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.

Text

Returns or sets the text for the specified object. Read/write String.

Top

Returns or sets a Double value that represents the distance, in points, from the top edge of the object to the top of row 1 (on a worksheet) or the top of the chart area (on a chart).

Type

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

VerticalAlignment

Returns or sets a Object value that represents the vertical alignment of the specified object.

Width

Gets the width, in points, of the object.

Methods

Delete()

Deletes the object.

Select()

Selects the object.

Applies to