Ao gerar um relatório do Word, você pode formatar a área de plotagem de um gráfico para complementar o restante do documento. A área de plotagem é onde o gráfico exibe seus dados. Ela está dentro da área maior do gráfico, que também pode conter um título e uma legenda.

Este tutorial mostra como criar um gráfico de colunas em C#, aplicar um preenchimento em degradê e uma borda à sua área de plotagem e salvar o gráfico em um documento Word.

Biblioteca C# para Formatar a Área de Plotagem de um Gráfico do Word

Aspose.Words for .NET permite que você crie e trabalhe com documentos Word em aplicações .NET. A API de preenchimento da área do gráfico e formatação de linha está disponível na versão 26.10 ou posterior.

Adicione o pacote ao seu projeto usando a CLI do .NET:

dotnet add package Aspose.Words --version 26.10.0

Você pode usar a biblioteca no modo de avaliação ou solicitar uma licença temporária gratuita para avaliá‑la sem limitações de avaliação.

Formatar a Área de Plotagem de um Gráfico do Word em C#

Siga estas etapas para criar e formatar um gráfico:

  1. Crie um Document e um DocumentBuilder.
  2. Insira um gráfico de colunas com InsertChart() e acesse o gráfico através da forma retornada.
  3. Limpe a série padrão e adicione suas próprias categorias e valores.
  4. Acesse Chart.PlotArea.Format.
  5. Aplique um preenchimento em gradiente e defina a cor e a largura da borda.
  6. Salve o documento como um arquivo DOCX.

O exemplo completo a seguir cria um gráfico com duas séries e formata sua área de plotagem:

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

Como funciona a formatação da área de plotagem

Um gráfico recém‑inserido contém dados gerados. O exemplo limpa suas séries e adiciona duas novas séries com valores para as mesmas duas categorias.

A propriedade Chart.PlotArea.Format fornece acesso ao preenchimento e à formatação de linhas da área de plotagem. OneColorGradient() define a cor, o estilo, a variante e o grau do gradiente. Stroke.ForeColor define a cor da borda, enquanto Stroke.Weight define sua espessura; o exemplo usa 0,25 pontos.

Visualizar o Gráfico Formatado

Abra formatted-chart-csharp.docx em um visualizador de documentos do Word. O documento contém um gráfico de colunas com duas séries de dados, um gradiente azul‑claro na área de plotagem e uma borda azul fina. Altere os valores de dados e formatação para corresponder ao seu relatório.

Formate a Área de Plotagem de um Gráfico do Word.

Formate a Área de Plotagem de um Gráfico do Word.

Conclusão

Você criou um gráfico de colunas no Word e personalizou sua área de plotagem usando C#. Experimente diferentes cores e dados em seus próprios relatórios e veja como criar gráficos no Word usando C# para mais exemplos de gráficos.

Veja Também