כאשר אתה מייצר דוח 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.

עיצוב אזור הפלט של תרשים Word.

סיכום

יצרת תרשים עמודות ב‑Word והתאמת את אזור הציור באמצעות C#. נסה צבעים ונתונים שונים בדוחות שלך, וצפה ב-כיצד ליצור תרשימים ב‑Word באמצעות C# לקבלת דוגמאות נוספות לתרשימים.

ראה גם