WPS 基础接口 > 表格 API 参考 > DataLabel > DataLabel 对象

代表图表数据点或趋势线上的数据标签。

说明

在数据系列上，DataLabel 对象是 DataLabels 集合的成员。DataLabels 集合包含每个数据点的 DataLabel 对象。对于没有可定义数据点的数据系列（如面积图数据系列），DataLabels 集合包含单个 DataLabel 对象。

示例

使用 DataLabels( index)（其中 index 为数据标签的索引号）可返回单个 DataLabel 对象。下例在第一张工作表上嵌入的第一个图表上，设置第一个数据系列中的第五个数据标签的数字格式。

示例代码 
Worksheets.Item(1).ChartObjects(1).Chart 
    .SeriesCollection(1).DataLabels(5).NumberFormat = "0.000"

使用 DataLabel 属性可返回单个数据点的 DataLabel 对象。下例打开名为“Chart1”的图表工作表上第一个数据系列中第二个数据点的数据标签，并将数据标签文本设置为“Saturday”。

示例代码 
let myChart = Charts.Item("Chart1")
    let myPoint = myChart.SeriesCollection(1).Points(2)
        myPoint.HasDataLabel = true
        myPoint.DataLabel.Text = "Saturday"

在趋势线上，DataLabel 返回与趋势线一起显示的文本。这些文本可能是公式、R 平方值或两者均有（如果两者都出现）。下例将趋势线文本设置为仅显示公式，并将数据标签文本置于工作表“Sheet1”上的单元格 A1 中。

示例代码 
let myChartline = Charts.Item("chart1").SeriesCollection(1).Trendlines(1)
    myChartline.DisplayRSquared = false
    myChartline.DisplayEquation = true
    Worksheets.Item("sheet1").Range("a1").Value2 = myChartline.DataLabel.Text


请参阅