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
)

參數

• Type
  型別：Microsoft.Office.Interop.Excel.XlDataLabelsType
  XlDataLabelsType .要套用的資料標籤類型。

• LegendKey
  型別：System.Object
  true 表示會在資料點旁顯示圖例符號。預設值是 false。

• AutoText
  型別：System.Object
  如果物件會根據內容自動產生適當的文字，則為 true。

• HasLeaderLines
  型別：System.Object
  對於 Chart 和 Series 物件，如果數列有指引線時，則為 true。

• ShowSeriesName
  型別：System.Object
  資料標籤的數列名稱。

• ShowCategoryName
  型別：System.Object
  資料標籤的類別名稱。

• ShowValue
  型別：System.Object
  資料標籤的值。

• ShowPercentage
  型別：System.Object
  資料標籤的百分比。

• ShowBubbleSize
  型別：System.Object
  資料標籤的泡泡大小。

• Separator
  型別：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 命名空間