Chart.ApplyDataLabels-Methode

Artikel
08/10/2011

Übernimmt Datenbeschriftungen für einen Punkt, eine Reihe oder alle Reihen in einem Chart-Steuerelement.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
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
)

Parameter

Type
Typ: Microsoft.Office.Interop.Excel.XlDataLabelsType
XlDataLabelsType.Der Typ der anzuwendenden Datenbeschriftung.

LegendKey
Typ: System.Object
true, um den Legendenschlüssel neben der Position anzuzeigen.Der Standardwert ist false.

AutoText
Typ: System.Object
true, wenn das Objekt automatisch auf Grundlage des Inhalts entsprechenden Text generiert.

HasLeaderLines
Typ: System.Object
Für das Chart-Objekt und das Series-Objekt true, wenn die Reihe über Führungslinien verfügt.

ShowSeriesName
Typ: System.Object
Der Reihename für die Datenbeschriftung.

ShowCategoryName
Typ: System.Object
Der Kategoriename für die Datenbeschriftung.

ShowValue
Typ: System.Object
Der Wert für die Datenbeschriftung.

ShowPercentage
Typ: System.Object
Der Prozentsatz für die Datenbeschriftung.

ShowBubbleSize
Typ: System.Object
Die Blasengröße für die Datenbeschriftung.

Separator
Typ: System.Object
Das Trennzeichen für die Datenbeschriftung.

Hinweise

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird ein Chart erstellt und anschließend die ApplyDataLabels-Eigenschaft verwendet, um Datenbeschriftungen mit dem Reihennamen des Diagramms anzuzeigen.

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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

Chart Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über