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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。