قالب‌بندی ناحیهٔ نمودار Word در C#

هنگامی که یک گزارش Word تولید می‌کنید، می‌توانید ناحیهٔ رسم نمودار را طوری قالب‌بندی کنید که با بقیهٔ سند هماهنگ باشد. ناحیهٔ رسم جایی است که نمودار داده‌های خود را نمایش می‌دهد. این ناحیه در داخل ناحیهٔ بزرگتر نمودار قرار دارد که می‌تواند شامل عنوان و افسانه نیز باشد.

این آموزش نشان می‌دهد که چگونه یک نمودار ستونی در C# ایجاد کنید، پرکنش گرادیان و حاشیه‌ای به ناحیه رسم آن اعمال کنید و نمودار را در یک سند Word ذخیره کنید.

کتابخانه C# برای قالب‌بندی ناحیه‌پلات نمودار Word

Aspose.Words for .NET به شما امکان می‌دهد تا اسناد Word را در برنامه‌های .NET ایجاد و با آن‌ها کار کنید. API پر کردن ناحیه نمودار و قالب‌بندی خطوط در نسخه 26.10 یا بعد از آن در دسترس است.

پکیج را با استفاده از .NET CLI به پروژه خود اضافه کنید:

dotnet add package Aspose.Words --version 26.10.0

می‌توانید کتابخانه را در حالت ارزیابی استفاده کنید یا برای دریافت یک مجوز موقت رایگان درخواست دهید تا بدون محدودیت‌های ارزیابی آن را بررسی کنید.

قالب‌بندی ناحیه‌نقشه یک نمودار Word در C#

برای ایجاد و قالب‌بندی یک نمودار، این مراحل را دنبال کنید:

1. یک Document و یک DocumentBuilder ایجاد کنید.
2. یک نمودار ستونی با InsertChart() وارد کنید و از طریق شکل بازگردانده شده به نمودار دسترسی پیدا کنید.
3. سری پیش‌فرض را پاک کنید و دسته‌ها و مقادیر خود را اضافه کنید.
4. به Chart.PlotArea.Format دسترسی پیدا کنید.
5. یک پر کردن گرادیان اعمال کنید و رنگ و عرض حاشیه را تنظیم کنید.
6. سند را به عنوان یک فایل DOCX ذخیره کنید.

مثال کامل زیر یک نمودار با دو سری ایجاد می‌کند و ناحیه‌نقشه آن را قالب‌بندی می‌کند:

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

نحوه کار قالب‌بندی ناحیه نمودار

یک نمودار تازه وارد شده شامل داده‌های تولید شده است. این مثال سری‌های آن را پاک می‌کند و دو سری جدید با مقادیر برای همان دو دسته اضافه می‌کند.

ویژگی Chart.PlotArea.Format دسترسی به پر کردن ناحیه نمودار و قالب‌بندی خطوط را فراهم می‌کند. OneColorGradient() رنگ گرادیان، سبک، نوع و درجه را تنظیم می‌کند. Stroke.ForeColor رنگ حاشیه را تنظیم می‌کند، در حالی که Stroke.Weight عرض آن را تنظیم می‌نماید؛ در مثال از 0.25 پوینت استفاده شده است.

مشاهده نمودار قالب‌بندی شده

فایل formatted-chart-csharp.docx را در یک نمایشگر سند Word باز کنید. این سند شامل یک نمودار ستونی با دو سری داده، یک گرادیان آبی روشن در ناحیه نمودار و یک حاشیه آبی نازک است. داده‌ها و مقادیر قالب‌بندی را طوری تغییر دهید که با گزارش شما مطابقت داشته باشد.

نتیجه‌گیری

شما یک نمودار ستونی Word ایجاد کرده‌اید و ناحیهٔ نمودار را با استفاده از C# سفارشی کرده‌اید. رنگ‌ها و داده‌های مختلف را در گزارش‌های خود امتحان کنید و برای مثال‌های بیشتر نمودار، نحوه ایجاد نمودارها در Word با استفاده از C# را ببینید.

موارد مرتبط

• حذف توقف‌های تب سطح فهرست از سند Word
• محاسبه امتیاز خواندن فلیش برای سند Word
• مبدل Markdown به Word