DataLabel Interface
Definition
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("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. |