Cuando generas un informe de Word, puedes formatear el área de trazado de un gráfico para complementar el resto del documento. El área de trazado es donde el gráfico muestra sus datos. Se encuentra dentro del área de gráfico más grande, que también puede contener un título y una leyenda.

Este tutorial le muestra cómo crear un gráfico de columnas en C#, aplicar un relleno degradado y un borde a su área de trazado, y guardar el gráfico en un documento de Word.

Biblioteca C# para Formatear el Área de Representación de un Gráfico de Word

Aspose.Words for .NET le permite crear y trabajar con documentos Word en aplicaciones .NET. La API de relleno y formato de línea del área de trazado está disponible a partir de la versión 26.10 o posterior.

Agrega el paquete a tu proyecto usando la CLI de .NET:

dotnet add package Aspose.Words --version 26.10.0

Puede usar la biblioteca en modo de evaluación o solicitar una licencia temporal gratuita para evaluarla sin limitaciones de evaluación.

Formatear el área de trazado de un gráfico de Word en C#

Siga estos pasos para crear y formatear un gráfico:

  1. Crea un Document y un DocumentBuilder.
  2. Inserta un gráfico de columnas con InsertChart() y accede al gráfico a través de la forma devuelta.
  3. Borra la serie predeterminada y agrega tus propias categorías y valores.
  4. Accede a Chart.PlotArea.Format.
  5. Aplica un relleno degradado y establece el color y el ancho del borde.
  6. Guarda el documento como un archivo DOCX.

El siguiente ejemplo completo crea un gráfico con dos series y formatea su área de trazado:

using System.Drawing;
using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Drawing.Charts;

class Program
{
    static void Main()
    {
        // Create a document and insert a column chart.
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);
        Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
        Chart chart = shape.Chart;

// Replace the default series with sample data.
        chart.Series.Clear();
        string[] categories = { "Quarter 1", "Quarter 2" };
        chart.Series.Add("2025", categories, new double[] { 1, 2 });
        chart.Series.Add("2026", categories, new double[] { 3, 4 });

// Set the plot-area fill and border.
        ChartPlotArea plotArea = chart.PlotArea;
        plotArea.Format.Fill.OneColorGradient(
            Color.LightBlue, GradientStyle.DiagonalUp,
            GradientVariant.Variant2, 1);
        plotArea.Format.Stroke.ForeColor = Color.Blue;
        plotArea.Format.Stroke.Weight = 0.25;

// Save the document.
        doc.Save("formatted-chart-csharp.docx");
    }
}

Cómo funciona el formato del área de trazado

Un gráfico recién insertado contiene datos generados. El ejemplo elimina sus series y agrega dos nuevas series con valores para las mismas dos categorías.

La propiedad Chart.PlotArea.Format proporciona acceso al relleno y al formato de línea del área del gráfico. OneColorGradient() establece el color, estilo, variante y grado del degradado. Stroke.ForeColor establece el color del borde, mientras que Stroke.Weight define su ancho; el ejemplo usa 0.25 puntos.

Ver el gráfico formateado

Abra formatted-chart-csharp.docx en un visor de documentos de Word. El documento contiene un gráfico de columnas con dos series de datos, un degradado azul claro en el área de trazado y un borde azul delgado. Cambie los valores de datos y formato para que coincidan con su informe.

Formatear el área de trazado de un gráfico de Word.

Formatear el área de trazado de un gráfico de Word.

Conclusión

Has creado un gráfico de columnas en Word y personalizado su área de trazado usando C#. Prueba diferentes colores y datos en tus propios informes, y consulta cómo crear gráficos en Word usando C# para más ejemplos de gráficos.

Véase también