Wenn Sie einen Word‑Bericht erstellen, können Sie den Plotbereich eines Diagramms formatieren, um den Rest des Dokuments zu ergänzen. Der Plotbereich ist der Bereich, in dem das Diagramm seine Daten anzeigt. Er befindet sich innerhalb des größeren Diagrammbereichs, der ebenfalls einen Titel und eine Legende enthalten kann.

Dieses Tutorial zeigt Ihnen, wie Sie ein Säulendiagramm in C# erstellen, eine Farbverlauf‑Füllung und einen Rand für den Plot‑Bereich anwenden und das Diagramm in einem Word‑Dokument speichern.

C#-Bibliothek zum Formatieren eines Word-Diagramm‑Plotbereichs

Aspose.Words for .NET ermöglicht es Ihnen, Word‑Dokumente in .NET‑Anwendungen zu erstellen und zu bearbeiten. Das Plot‑Area‑Füll‑ und Linienformatierungs‑API ist ab Version 26.10 oder höher verfügbar.

Fügen Sie das Paket zu Ihrem Projekt mit der .NET CLI hinzu:

dotnet add package Aspose.Words --version 26.10.0

Sie können die Bibliothek im Evaluierungsmodus verwenden oder eine kostenlose temporäre Lizenz anfordern, um sie ohne Evaluierungsbeschränkungen zu testen.

Formatieren des Plotbereichs eines Word-Diagramms in C#

Führen Sie die folgenden Schritte aus, um ein Diagramm zu erstellen und zu formatieren:

  1. Erstellen Sie ein Document und einen DocumentBuilder.
  2. Fügen Sie ein Säulendiagramm mit InsertChart() ein und greifen Sie über das zurückgegebene Shape auf das Diagramm zu.
  3. Löschen Sie die Standardserie und fügen Sie Ihre eigenen Kategorien und Werte hinzu.
  4. Greifen Sie auf Chart.PlotArea.Format zu.
  5. Wenden Sie eine Farbverlauffüllung an und setzen Sie die Rahmenfarbe und -breite.
  6. Speichern Sie das Dokument als DOCX-Datei.

Das folgende vollständige Beispiel erstellt ein Diagramm mit zwei Datenreihen und formatiert dessen Plotbereich:

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

Wie die Formatierung des Diagrammbereichs funktioniert

Ein neu eingefügtes Diagramm enthält generierte Daten. Das Beispiel löscht seine Serien und fügt zwei neue Serien mit Werten für dieselben beiden Kategorien hinzu.

Die Chart.PlotArea.Format Eigenschaft bietet Zugriff auf die Füll‑ und Linienformatierung des Diagrammbereichs. OneColorGradient() legt die Farbverlauffarbe, den Stil, die Variante und den Grad fest. Stroke.ForeColor legt die Randfarbe fest, während Stroke.Weight die Breite bestimmt; das Beispiel verwendet 0,25 Punkte.

Formatiertes Diagramm anzeigen

Öffnen Sie formatted-chart-csharp.docx in einem Word‑Dokumentbetrachter. Das Dokument enthält ein Säulendiagramm mit zwei Datenreihen, einem hellblauen Farbverlauf im Diagrammbereich und einem dünnen blauen Rand. Ändern Sie die Daten‑ und Formatierungswerte, um sie an Ihren Bericht anzupassen.

Formatieren Sie den Plotbereich eines Word-Diagramms.

Formatieren Sie den Plotbereich eines Word-Diagramms.

Fazit

Sie haben ein Word‑Säulendiagramm erstellt und den Plotbereich mit C# angepasst. Probieren Sie verschiedene Farben und Daten in Ihren eigenen Berichten aus und sehen Sie sich wie man Diagramme in Word mit C# erstellt für weitere Diagrammbeispiele an.

Siehe auch