ChartDataLabel

ChartDataLabel class

Représente l’étiquette de données sur un point de graphique ou une ligne de tendance.

Pour en savoir plus, visitez leTravailler avec des graphiques article de documentation.

public class ChartDataLabel

Propriétés

Nom	La description
Font { get; }	Donne accès au formatage de police de cette étiquette de données.
Format { get; }	Donne accès au remplissage et au formatage des lignes de l’étiquette de données.
Index { get; }	Spécifie l’index de l’élément conteneur. Cet index doit déterminer à quelle collection d’enfants du parent cet élément s’applique. La valeur par défaut est 0.
IsHidden { get; set; }	Obtient/définit un indicateur indiquant si cette étiquette est masquée. La valeur par défaut est`FAUX` .
IsVisible { get; }	Retours`vrai` si cette étiquette de données a quelque chose à afficher.
Left { get; set; }	Obtient ou définit la distance de l’étiquette de données en points à partir du bord gauche du graphique ou de la position spécifiée par son`Position` propriété, en fonction de la valeur de la`LeftMode` Propriété .
LeftMode { get; set; }	Obtient ou définit le mode d’interprétation du`Left` valeur de la propriété : si elle définit l’emplacement de l’étiquette de données à partir du bord gauche du graphique ou à partir de la position spécifiée par son`Position` Propriété .
NumberFormat { get; }	Renvoie le format numérique de l’élément parent.
Orientation { get; set; }	Obtient ou définit l’orientation du texte de l’étiquette.
Position { get; set; }	Obtient ou définit la position de l’étiquette de données.
Rotation { get; set; }	Obtient ou définit la rotation de l’étiquette en degrés.
Separator { get; set; }	Obtient ou définit le séparateur de chaîne utilisé pour les étiquettes de données sur un graphique. La valeur par défaut est une virgule, sauf pour les graphiques à secteurs affichant uniquement le nom de la catégorie et le pourcentage, où un saut de ligne doit être utilisé à la place.
ShowBubbleSize { get; set; }	Permet de spécifier si la taille des bulles doit être affichée pour les étiquettes de données sur un graphique. S’applique uniquement aux graphiques à bulles. La valeur par défaut est`FAUX` .
ShowCategoryName { get; set; }	Permet de spécifier si le nom de la catégorie doit être affiché pour les étiquettes de données sur un graphique. La valeur par défaut est`FAUX` .
ShowDataLabelsRange { get; set; }	Permet de spécifier si les valeurs des étiquettes de données doivent être affichées dans les étiquettes de données. La valeur par défaut est`FAUX` .
ShowLeaderLines { get; set; }	Permet de spécifier si les lignes de repère des étiquettes de données doivent être affichées. La valeur par défaut est`FAUX` .
ShowLegendKey { get; set; }	Permet de spécifier si la clé de légende doit être affichée pour les étiquettes de données sur un graphique. La valeur par défaut est`FAUX` .
ShowPercentage { get; set; }	Permet de spécifier si la valeur en pourcentage doit être affichée pour les étiquettes de données sur un graphique. La valeur par défaut est`FAUX` .
ShowSeriesName { get; set; }	Renvoie ou définit une valeur booléenne pour indiquer le comportement d’affichage du nom de la série pour les étiquettes de données sur un graphique. `vrai` pour afficher le nom de la série ;`FAUX` pour masquer. Par défaut`FAUX` .
ShowValue { get; set; }	Permet de spécifier si les valeurs doivent être affichées dans les étiquettes de données. La valeur par défaut est`FAUX` .
Top { get; set; }	Obtient ou définit la distance de l’étiquette de données en points à partir du bord supérieur du graphique ou de la position spécifiée par son`Position` propriété, en fonction de la valeur de la`TopMode` Propriété .
TopMode { get; set; }	Obtient ou définit le mode d’interprétation du`Top` valeur de la propriété : si elle définit l’emplacement de l’étiquette de données à partir du bord supérieur du graphique ou à partir de la position spécifiée par son`Position` Propriété .

Méthodes

Nom	La description
ClearFormat()	Efface le format de cette étiquette de données. Les propriétés sont définies sur les valeurs par défaut définies dans la collection d’étiquettes parente data .

Remarques

Sur une série, leChartDataLabel l’objet est un membre duChartDataLabelCollection . LeChartDataLabelCollection contient unChartDataLabel objet pour chaque point.

Exemples

Montre comment appliquer des étiquettes aux points de données dans un graphique linéaire.

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);

    // Appliquer des étiquettes de données à chaque série du graphique.
    // Ces étiquettes apparaîtront à côté de chaque point de données dans le graphique et afficheront sa valeur.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Modifiez la chaîne de séparation pour chaque étiquette de données d'une série.
    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;

    // Pour un graphique plus propre, nous pouvons supprimer les étiquettes de données individuellement.
    dataLabel.ClearFormat();

    // Nous pouvons également supprimer une série entière de ses étiquettes de données à la fois.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Appliquez des étiquettes de données avec un format numérique personnalisé et un séparateur à plusieurs points de données d'une série.
/// </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);
    }
}

Voir également

espace de noms Aspose.Words.Drawing.Charts
Assemblée Aspose.Words

ChartAxisType Enum ChartDataLabelCollection Class