ChartDataLabelCollection

ChartDataLabelCollection class

Représente une collection deChartDataLabel .

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

public class ChartDataLabelCollection : IEnumerable<ChartDataLabel>

Propriétés

NomLa description
Count { get; }Renvoie le nombre deChartDataLabel dans cette collection.
Font { get; }Donne accès au formatage des polices des étiquettes de données de toute la série.
Format { get; }Donne accès au remplissage et au formatage des lignes des étiquettes de données.
Item { get; }RetoursChartDataLabel pour l’index spécifié.
NumberFormat { get; }Obtient unChartNumberFormat instance permettant de définir le format numérique des étiquettes de données de la série entière.
Orientation { get; set; }Obtient ou définit l’orientation du texte des étiquettes de données de la série entière.
Position { get; set; }Obtient ou définit la position des étiquettes de données.
Rotation { get; set; }Obtient ou définit la rotation des étiquettes de données de la série entière en degrés.
Separator { get; set; }Obtient ou définit le séparateur de chaîne utilisé pour les étiquettes de données de la série entière. La valeur par défaut est une virgule, sauf pour les graphiques à secteurs affichant uniquement le nom de la catégorie et le pourcentage, lorsqu’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 de la série entière. S’applique uniquement aux graphiques à bulles. La valeur par défaut estFAUX .
ShowCategoryName { get; set; }Permet de spécifier si le nom de la catégorie doit être affiché pour les étiquettes de données de la série entière. La valeur par défaut estFAUX .
ShowDataLabelsRange { get; set; }Permet de spécifier si les valeurs de la plage d’étiquettes de données doivent être affichées dans les étiquettes de données de la série entière. La valeur par défaut estFAUX .
ShowLeaderLines { get; set; }Permet de spécifier si les lignes de repère des étiquettes de données doivent être affichées pour les étiquettes de données de la série entière. La valeur par défaut estFAUX .
ShowLegendKey { get; set; }Permet de spécifier si la clé de légende doit être affichée pour les étiquettes de données de la série entière. La valeur par défaut estFAUX .
ShowPercentage { get; set; }Permet de spécifier si la valeur en pourcentage doit être affichée pour les étiquettes de données de la série entière. La valeur par défaut estFAUX . S’applique uniquement aux graphiques à secteurs.
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 de la série entière. vrai pour afficher le nom de la série ;FAUX pour masquer. Par défautFAUX .
ShowValue { get; set; }Permet de spécifier si les valeurs doivent être affichées dans les étiquettes de données de la série entière. La valeur par défaut estFAUX .

Méthodes

NomLa description
ClearFormat()Efface le format de tousChartDataLabel dans cette collection.
GetEnumerator()Renvoie un objet énumérateur.

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

ChartDataLabel Class ChartDataLabelLocationMode Enum