DataLabel Interface

Reference

Definition

Namespace:: Microsoft.Office.Interop.Excel

Assembly:: Microsoft.Office.Interop.Excel.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Represents the data label on a chart point or trendline.

public interface class DataLabel

[System.Runtime.InteropServices.Guid("000208B2-0000-0000-C000-000000000046")]
[System.Runtime.InteropServices.InterfaceType(2)]
public interface DataLabel

Public Interface DataLabel

Attributes: GuidAttribute InterfaceTypeAttribute

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.

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

Use the DataLabel property to return the DataLabel object for a single point.

On a trendline, the DataLabel property returns the text shown with the trendline. This can be the equation, the R-squared value, or both (if both are showing).

Properties

_Height
_Width
Application	Returns an Application object that represents the Microsoft Excel application. 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	The data label text. Read/write String.
Characters[Object, Object]	Returns a Characters object that represents a range of characters within the object text. You can use the Characters object to format characters within a text string.
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	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 ChartFormat object. Read-only.
Formula	Gets or sets a value that represents the formula of the object using A1-style notation, in English.
FormulaLocal	Gets or sets a value that represents the formula of the object using A1-style notation, in the language of the user.
FormulaR1C1	Gets or sets a value that represents the formula of the object using R1C1-style notation, in English.
FormulaR1C1Local	Gets or sets a value that represents the formula of 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 the horizontal alignment for the specified object.
Interior	Returns an Interior object that represents the interior of the specified object.
Left	The distance, in points, from the left edge of the object to the left edge of column A (on a worksheet) or the left edge of the chart area (on a chart). Read/write Double.
Name	Returns the name of the object. Read-only String.
NumberFormat	Returns or sets the format code for the object. Read/write String.
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 the format code for the object as a string in the language of the user. Read/write Object.
Orientation	The text orientation. Can be an integer value from –90 to 90 degrees.
Parent	Returns the parent object for the specified object. Read-only.
Position	Returns or sets the position of the data label. Read/write XlDataLabelPosition.
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	Sets or returns an Object representing the separator used for the data labels on a chart. Read/write.
Shadow	True if the object has a shadow. Read/write Boolean.
ShowBubbleSize	True to show the bubble size for the data labels on a chart. False to hide. Read/write Boolean.
ShowCategoryName	True to display the category name for the data labels on a chart. False to hide. Read/write Boolean.
ShowLegendKey	True if the data label legend key is visible. Read/write Boolean.
ShowPercentage	True to display the percentage value for the data labels on a chart. False to hide. Read/write Boolean.
ShowRange	Used to toggle the Range field if it exists on the data label range. Boolean (bool in C#) Read/Write
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-only String.
Top	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). Read/write Double.
Type	Returns or sets the label type. Read/write Object.
VerticalAlignment	Returns or sets 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

Share via