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 para rellenar y formatear las líneas de las etiquetas de datos.
Item { get; }DevuelveChartDataLabel para el índice especificado.
NumberFormat { get; }Obtiene unChartNumberFormat instancia que permite establecer el formato de número para las etiquetas de datos de toda la serie .
Orientation { get; set; }Obtiene o establece la orientación del texto de las etiquetas de datos de toda la serie.
Position { get; set; }Obtiene o establece la posición de las etiquetas de datos.
Rotation { get; set; }Obtiene o establece la rotación de las etiquetas de datos de toda la serie en grados.
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 para los gráficos circulares que muestran solo el nombre de la categoría y el porcentaje, en cuyo caso se debe utilizar un salto de línea en su lugar.
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 se debe mostrar el nombre de la categoría para las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .
ShowDataLabelsRange { get; set; }Permite especificar si los valores del rango de 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 se deben mostrar las líneas guía de las etiquetas de datos para las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .
ShowLegendKey { get; set; }Permite especificar si se mostrará la clave de leyenda 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 solo 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 para ocultar. Por defectoFALSO .
ShowValue { get; set; }Permite especificar si se mostrarán valores en las etiquetas de datos de toda la serie. El valor predeterminado esFALSO .

Métodos

NombreDescripción
ClearFormat()Borra el formato de todosChartDataLabel 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 en una 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;

    // Para obtener un gráfico más limpio, podemos eliminar las etiquetas de datos individualmente.
    dataLabel.ClearFormat();

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

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

/// <summary>
/// Aplicar 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)
{
    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);
    }
}

Ver también

ChartDataLabel Class ChartDataLabelLocationMode Enum