ChartDataLabelCollection

ChartDataLabelCollection class

Representa una colección deChartDataLabel .

Para obtener más información, visite elTrabajar con gráficos artículo de documentación.

public class ChartDataLabelCollection : IEnumerable<ChartDataLabel>

Propiedades

NombreDescripción
Count { get; }Devuelve el número deChartDataLabel en esta colección.
Font { get; }Proporciona acceso al formato de fuente de las etiquetas de datos de toda la serie.
Format { get; }Proporciona acceso al formato de relleno y línea de las etiquetas de datos.
Item { get; }DevolucionesChartDataLabel para el índice especificado.
NumberFormat { get; }Obtiene unChartNumberFormat instancia que permite establecer el formato numérico para las etiquetas de datos de la serie completa.
Separator { get; set; }Obtiene o establece el separador de cadena utilizado para las etiquetas de datos de toda la serie. El valor predeterminado es una coma, excepto en los gráficos circulares que muestran solo el nombre de la categoría y el porcentaje, cuando en su lugar se utilizará un salto de línea .
ShowBubbleSize { get; set; }Permite especificar si se mostrará el tamaño de la burbuja para las etiquetas de datos de toda la serie. Se aplica solo a los gráficos de burbujas. El valor predeterminado esFALSO .
ShowCategoryName { get; set; }Permite especificar si el nombre de la categoría se mostrará para las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .
ShowDataLabelsRange { get; set; }Permite especificar si los valores de las etiquetas de datos se mostrarán en las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .
ShowLeaderLines { get; set; }Permite especificar si las líneas guía de las etiquetas de datos deben mostrarse para las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .
ShowLegendKey { get; set; }Permite especificar si la clave de leyenda se mostrará para las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .
ShowPercentage { get; set; }Permite especificar si se mostrará el valor porcentual para las etiquetas de datos de toda la serie. El valor predeterminado esFALSO . Se aplica sólo a gráficos circulares.
ShowSeriesName { get; set; }Devuelve o establece un valor booleano para indicar el comportamiento de visualización del nombre de la serie para las etiquetas de datos de toda la serie. verdadero para mostrar el nombre de la serie;FALSO esconder. Por defectoFALSO .
ShowValue { get; set; }Permite especificar si los valores se mostrarán en las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .

Métodos

NombreDescripción
ClearFormat()Borra el formato de todoChartDataLabel en esta colección.
GetEnumerator()Devuelve un objeto enumerador.

Ejemplos

Muestra cómo aplicar etiquetas a puntos de datos en un gráfico de líneas.

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

    // Aplicar etiquetas de datos a cada serie del gráfico.
    // Estas etiquetas aparecerán junto a cada punto de datos en el gráfico y mostrarán su valor.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Cambia la cadena separadora para cada etiqueta de datos de una serie.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    // Para obtener un gráfico más limpio, podemos eliminar las etiquetas de datos individualmente.
    chart.Series[1].DataLabels[2].ClearFormat();

    // También podemos eliminar una serie completa de sus etiquetas de datos a la vez.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Aplique etiquetas de datos con formato de número personalizado y separador a varios puntos de datos en una serie.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    for (int i = 0; i < labelsCount; i++)
    {
        series.HasDataLabels = true;

        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;
        series.DataLabels[i].IsHidden = false;
        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);
    }
}

Ver también

ChartDataLabel Class ChartDataPoint Class