ChartDataLabel

ChartDataLabel class

Representerar dataetiketten på en diagrampunkt eller trendlinje.

För att lära dig mer, besökArbeta med diagram dokumentationsartikel.

public class ChartDataLabel

Egenskaper

namn	Beskrivning
Font { get; }	Ger åtkomst till teckensnittsformateringen för denna dataetikett.
Format { get; }	Ger åtkomst till fyllnings- och linjeformatering av dataetiketten.
Index { get; }	Anger indexet för det innehållande elementet. Detta index ska avgöra vilken av de överordnade och underordnade samlingarna detta element gäller för. Standardvärdet är 0.
IsHidden { get; set; }	Hämtar/ställer in en flagga som anger om denna etikett är dold. Standardvärdet ärfalsk .
IsVisible { get; }	Returersann om den här dataetiketten har något att visa.
Left { get; set; }	Hämtar eller anger avståndet för dataetiketten i punkter från diagrammets vänstra kant eller från positionen som anges av dessPosition egendom, beroende på värdet avLeftMode egenskap.
LeftMode { get; set; }	Hämtar eller ställer in tolkningsläget förLeft egenskapsvärde: om den anger location för dataetiketten från diagrammets vänstra kant eller från den position som anges av dessPosition egenskap.
NumberFormat { get; }	Returnerar talformatet för det överordnade elementet.
Orientation { get; set; }	Hämtar eller anger orienteringen för etikettexten.
Position { get; set; }	Hämtar eller anger positionen för dataetiketten.
Rotation { get; set; }	Hämtar eller ställer in rotationen av etiketten i grader.
Separator { get; set; }	Hämtar eller ställer in strängavgränsare som används för dataetiketter i ett diagram. Standardvärdet är ett kommatecken, förutom för cirkeldiagram som endast visar kategorinamn och procentandel, då en radbrytning ska användas istället.
ShowBubbleSize { get; set; }	Gör det möjligt att ange om bubbelstorlek ska visas för dataetiketterna i ett diagram. Gäller endast bubbeldiagram. Standardvärdet ärfalsk .
ShowCategoryName { get; set; }	Gör det möjligt att ange om kategorinamnet ska visas för dataetiketterna i ett diagram. Standardvärdet ärfalsk .
ShowDataLabelsRange { get; set; }	Gör det möjligt att ange om värden från dataetikettintervallet ska visas i dataetiketterna. Standardvärdet ärfalsk .
ShowLeaderLines { get; set; }	Gör det möjligt att ange om riktlinjer för dataetiketter behöver visas. Standardvärdet ärfalsk .
ShowLegendKey { get; set; }	Gör det möjligt att ange om förklaringsnyckeln ska visas för dataetiketterna i ett diagram. Standardvärdet ärfalsk .
ShowPercentage { get; set; }	Gör det möjligt att ange om procentvärde ska visas för dataetiketterna i ett diagram. Standardvärdet ärfalsk .
ShowSeriesName { get; set; }	Returnerar eller anger ett booleskt värde för att ange visningsbeteendet för serienamn för dataetiketterna i ett diagram. sann för att visa seriens namn;falsk att dölja. Som standardfalsk .
ShowValue { get; set; }	Gör det möjligt att ange om värden ska visas i dataetiketterna. Standardvärdet ärfalsk .
Top { get; set; }	Hämtar eller ställer in dataetikettens avstånd i punkter från diagrammets överkant eller från positionen som anges av dessPosition egendom, beroende på värdet avTopMode egenskap.
TopMode { get; set; }	Hämtar eller ställer in tolkningsläget förTop egenskapsvärde: om den anger location för dataetiketten från diagrammets överkant eller från den position som anges av dessPosition egenskap.

Metoder

namn	Beskrivning
ClearFormat()	Rensar formatet för denna dataetikett. Egenskaperna ställs in på standardvärdena som definierats i den överordnade data etikettsamlingen.

Anmärkningar

På en serie, denChartDataLabel objektet är medlem iChartDataLabelCollection . DenChartDataLabelCollection innehåller enChartDataLabel objekt för varje punkt.

Exempel

Visar hur man applicerar etiketter på datapunkter i ett linjediagram.

public void DataLabels()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    Shape chartShape = builder.InsertChart(ChartType.Line, 400, 300);
    Chart chart = chartShape.Chart;

    Assert.AreEqual(3, chart.Series.Count);
    Assert.AreEqual("Series 1", chart.Series[0].Name);
    Assert.AreEqual("Series 2", chart.Series[1].Name);
    Assert.AreEqual("Series 3", chart.Series[2].Name);

    // Använd dataetiketter på varje serie i diagrammet.
    // Dessa etiketter visas bredvid varje datapunkt i grafen och visar dess värde.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Ändra avgränsningssträngen för varje dataetikett i en serie.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    ChartDataLabel dataLabel = chart.Series[1].DataLabels[2];
    dataLabel.Format.Fill.Color = Color.Red;

    // För en renare graf kan vi ta bort dataetiketter individuellt.
    dataLabel.ClearFormat();

    // Vi kan också ta bort en hel serie av dess dataetiketter samtidigt.
    chart.Series[2].DataLabels.ClearFormat();

    doc.Save(ArtifactsDir + "Charts.DataLabels.docx");
}

/// <summary>
/// Använd dataetiketter med anpassat talformat och avgränsare på flera datapunkter i en serie.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    series.HasDataLabels = true;
    series.Explosion = 40;

    for (int i = 0; i < labelsCount; i++)
    {
        Assert.False(series.DataLabels[i].IsVisible);

        series.DataLabels[i].ShowCategoryName = true;
        series.DataLabels[i].ShowSeriesName = true;
        series.DataLabels[i].ShowValue = true;
        series.DataLabels[i].ShowLeaderLines = true;
        series.DataLabels[i].ShowLegendKey = true;
        series.DataLabels[i].ShowPercentage = false;
        Assert.False(series.DataLabels[i].IsHidden);
        Assert.False(series.DataLabels[i].ShowDataLabelsRange);

        series.DataLabels[i].NumberFormat.FormatCode = numberFormat;
        series.DataLabels[i].Separator = separator;

        Assert.False(series.DataLabels[i].ShowDataLabelsRange);
        Assert.True(series.DataLabels[i].IsVisible);
        Assert.False(series.DataLabels[i].IsHidden);
    }
}

Se även

• namnutrymme Aspose.Words.Drawing.Charts
• hopsättning Aspose.Words