När du skapar en Word‑rapport kan du formatera diagrammets plotområde för att komplettera resten av dokumentet. Plotområdet är där diagrammet visar sina data. Det ligger inom det större diagramområdet, som också kan innehålla en titel och en legend.

Den här handledningen visar hur du skapar ett stapeldiagram i C#, applicerar en gradientfyllning och en kantlinje på dess plotområde och sparar diagrammet i ett Word‑dokument.

C#-bibliotek för att formatera ett Word-diagrammets plotområde

Aspose.Words for .NET låter dig skapa och arbeta med Word-dokument i .NET-applikationer. Plot‑område fyllning och linjeformatering API är tillgängligt i version 26.10 eller senare.

Lägg till paketet i ditt projekt med .NET CLI:

dotnet add package Aspose.Words --version 26.10.0

Du kan använda biblioteket i utvärderingsläge eller begära en gratis tillfällig licens för att utvärdera det utan utvärderingsbegränsningar.

Formatera plotområdet i ett Word-diagram i C#

Följ dessa steg för att skapa och formatera ett diagram:

  1. Skapa ett Document och en DocumentBuilder.
  2. Infoga ett stapeldiagram med InsertChart() och få åtkomst till diagrammet via den returnerade shape.
  3. Rensa den standardserie och lägg till dina egna kategorier och värden.
  4. Åtkomst Chart.PlotArea.Format.
  5. Tillämpa en gradientfyllning och ange kantfärgen och bredden.
  6. Spara dokumentet som en DOCX‑fil.

Följande kompletta exempel skapar ett diagram med två serier och formaterar plotområdet:

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

Hur formatering av plotområdet fungerar

Ett nyinfogat diagram innehåller genererade data. Exemplet rensar dess serier och lägger till två nya serier med värden för samma två kategorier.

Egenskapen Chart.PlotArea.Format ger åtkomst till plotområdets fyllning och linjeformatering. OneColorGradient() ställer in gradientens färg, stil, variant och grad. Stroke.ForeColor anger kantfärgen, medan Stroke.Weight anger dess bredd; exemplet använder 0.25 punkter.

Visa det formaterade diagrammet

Öppna formatted-chart-csharp.docx i en Word‑dokumentvisare. Dokumentet innehåller ett stapeldiagram med två dataserier, en ljusblå gradient i diagramområdet och en tunn blå kant. Ändra data‑ och formateringsvärdena så att de matchar din rapport.

Formatera plotområdet i ett Word-diagram.

Formatera plotområdet i ett Word-diagram.

Slutsats

Du har skapat ett stapeldiagram i Word och anpassat dess diagramområde med C#. Prova olika färger och data i dina egna rapporter, och se hur du skapar diagram i Word med C# för fler diagramexempel.

Se också