通过

Chart.ApplyDataLabels 方法

将数据标签应用于 Chart 控件的某个点、某个系列或所有系列。

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel（在 Microsoft.Office.Tools.Excel.dll 中）

语法

声明
Sub ApplyDataLabels ( _
    Type As XlDataLabelsType, _
    LegendKey As Object, _
    AutoText As Object, _
    HasLeaderLines As Object, _
    ShowSeriesName As Object, _
    ShowCategoryName As Object, _
    ShowValue As Object, _
    ShowPercentage As Object, _
    ShowBubbleSize As Object, _
    Separator As Object _
)

void ApplyDataLabels(
    XlDataLabelsType Type,
    Object LegendKey,
    Object AutoText,
    Object HasLeaderLines,
    Object ShowSeriesName,
    Object ShowCategoryName,
    Object ShowValue,
    Object ShowPercentage,
    Object ShowBubbleSize,
    Object Separator
)

参数

  • LegendKey
    类型：System.Object
    为 true 时，在点旁边显示图例项标示。默认值为 false。
  • AutoText
    类型：System.Object
    如果对象自动根据内容生成适当的文本，则为 true。
  • HasLeaderLines
    类型：System.Object
    对于 Chart 和 Series 对象而言，如果系列包含引导线，则为 true。
  • ShowSeriesName
    类型：System.Object
    数据标签的系列名称。
  • ShowCategoryName
    类型：System.Object
    数据标签的类别名称。
  • ShowPercentage
    类型：System.Object
    数据标签的百分比。
  • ShowBubbleSize
    类型：System.Object
    数据标签的气泡大小。

备注

可选参数

有关可选参数的信息，请参见Office 解决方案中的可选参数。

示例

下面的代码示例创建一个 Chart，然后使用 ApplyDataLabels 方法在图表上显示带系列名称的数据标签。

Private Sub DisplayLabels()
    Me.Range("A1", "A5").Value2 = 22
    Me.Range("B1", "B5").Value2 = 55

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H20"), "Chart1")

    Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xlBarClustered

    Chart1.ApplyDataLabels(Excel.XlDataLabelsType.xlDataLabelsShowLabel, _
        False, False, False, True, False, False, False, False, False)
End Sub

private void DisplayLabels()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H20"], 
        "chart1");

    chart1.SetSourceData(this.Range["A1", "B5"], 
        Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlBarClustered;

    chart1.ApplyDataLabels(
        Excel.XlDataLabelsType.xlDataLabelsShowLabel,
        false, false, false, true, false, false, false, 
        false, false);
}

.NET Framework 安全性

请参见

参考

Chart 接口

Microsoft.Office.Tools.Excel 命名空间