Kiedy generujesz raport Word, możesz sformatować obszar wykresu, aby uzupełniał resztę dokumentu. Obszar wykresu to miejsce, w którym wykres wyświetla swoje dane. Znajduje się on wewnątrz większego obszaru wykresu, który może również zawierać tytuł i legendę.

Ten samouczek pokazuje, jak utworzyć wykres kolumnowy w C#, zastosować wypełnienie gradientowe i obramowanie obszaru wykresu oraz zapisać wykres w dokumencie Word.

Biblioteka C# do formatowania obszaru wykresu Word

Aspose.Words for .NET pozwala tworzyć i pracować z dokumentami Word w aplikacjach .NET. API formatowania wypełnienia i linii obszaru wykresu jest dostępne w wersji 26.10 lub później.

Dodaj pakiet do swojego projektu przy użyciu .NET CLI:

dotnet add package Aspose.Words --version 26.10.0

Możesz używać biblioteki w trybie ewaluacji lub poprosić o bezpłatną tymczasową licencję, aby ocenić ją bez ograniczeń ewaluacji.

Formatuj obszar wykresu w dokumencie Word w C#

Postępuj zgodnie z poniższymi krokami, aby utworzyć i sformatować wykres:

  1. Utwórz Document i DocumentBuilder.
  2. Wstaw wykres kolumnowy za pomocą InsertChart() i uzyskaj dostęp do wykresu poprzez zwrócony kształt.
  3. Wyczyść domyślną serię i dodaj własne kategorie oraz wartości.
  4. Uzyskaj dostęp do Chart.PlotArea.Format.
  5. Zastosuj wypełnienie gradientowe i ustaw kolor oraz szerokość obramowania.
  6. Zapisz dokument jako plik DOCX.

Poniższy kompletny przykład tworzy wykres z dwoma seriami i formatuje jego obszar wykresu:

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

Jak działa formatowanie obszaru wykresu

Nowo wstawiony wykres zawiera wygenerowane dane. Przykład czyści jego serie i dodaje dwie nowe serie z wartościami dla tych samych dwóch kategorii.

Właściwość Chart.PlotArea.Format zapewnia dostęp do wypełnienia i formatowania linii obszaru wykresu. OneColorGradient() ustawia kolor gradientu, styl, wariant i stopień. Stroke.ForeColor ustawia kolor obramowania, natomiast Stroke.Weight określa jego szerokość; w przykładzie użyto 0,25 punktu.

Wyświetl sformatowany wykres

Otwórz formatted-chart-csharp.docx w przeglądarce dokumentów Word. Dokument zawiera wykres słupkowy z dwoma seriami danych, gradient w odcieniach jasnoniebieskiego w obszarze wykresu oraz cienką niebieską ramkę. Zmień wartości danych i formatowania, aby pasowały do Twojego raportu.

Formatuj obszar wykresu w dokumencie Word.

Formatuj obszar wykresu w dokumencie Word.

Podsumowanie

Utworzyłeś wykres słupkowy w Wordzie i dostosowałeś jego obszar wykresu przy użyciu C#. Wypróbuj różne kolory i dane w własnych raportach oraz zobacz jak tworzyć wykresy w Wordzie przy użyciu C# po więcej przykładów wykresów.

Zobacz także