الرسم البياني

أضف الرسم البياني

func (f *File) AddChart(sheet, cell string, chart *ChartOptions, combo ...*ChartOptions) error

يوفر AddChart طريقة لإضافة مخطط في ورقة عمل من خلال مجموعة تنسيق مخطط معين (مثل الإزاحة والقياس وإعدادات نسبة العرض إلى الارتفاع وإعدادات الطباعة) ومجموعة الخصائص.

يوضح ما يلي Type الرسم البياني الذي يدعمه برنامج excelize:

في نطاق بيانات مخطط Office Excel ، تحدد Series مجموعة المعلومات التي سيتم رسم البيانات لها ، وعنصر وسيلة الإيضاح (سلسلة) ، وتسمية المحور الأفقي (الفئة).

خيارات Series التي يمكن تعيينها هي:

تعيين خصائص وسيلة إيضاح الرسم البياني. الخيارات التي يمكن ضبطها هي:

قم بتعيين Position لوسيلة إيضاح الرسم البياني. موضع وسيلة الإيضاح الافتراضي هو right. الوظائف المتاحة هي:

تعيين المعلمة ShowLegendKey ، يجب أن تظهر مفاتيح وسيلة الإيضاح في ملصقات البيانات. القيمة الافتراضية هي false.

يمكنك تحديد خصائص عنوان الرسم البياني باستخدام حقل Title بنوع بيانات ChartTitle. الخصائص التي يمكن تحديدها هي:

توفر المعلمة ShowBlanksAs إعداد "إخفاء الخلايا وإفراغها". القيمة الافتراضية هي: gap. في تطبيق Excel "يتم عرض الخلية الفارغة على أنها": "الفراغ". فيما يلي قيم اختيارية لهذه المعلمة:

تعيين أسطورة الرسم البياني لجميع سلاسل البيانات باستخدام خاصية Legend. خاصية Legend اختيارية.

قم بتعيين حجم الفقاعة في كافة سلاسل البيانات للمخطط الفقاعي أو المخطط الفقاعي ثلاثي الأبعاد بواسطة خاصية BubbleSizes. الخاصية BubbleSizes اختيارية. العرض الافتراضي هو 100، ويجب أن تكون القيمة أكبر من 0 وأقل أو تساوي 300.

قم بتعيين حجم فتحة الكعكة في كافة سلاسل البيانات للمخطط الدائري بواسطة خاصية HoleSize. الخاصية HoleSize اختيارية. العرض الافتراضي هو 75، ويجب أن تكون القيمة أكبر من 0 وأقل أو تساوي 90.

يحدد أن لكل علامة بيانات في السلسلة لون مختلف حسب VaryColors. القيمة الافتراضية هي true.

توفر المعلمة Format إعدادات للمعلمات مثل إزاحة المخطط ، والمقياس ، وإعدادات نسبة العرض إلى الارتفاع ، وخصائص الطباعة ، بالإضافة إلى تلك المستخدمة في الوظيفة AddPicture.

قم بتعيين خصائص منطقة الرسم البياني باستخدام حقل PlotArea بنوع بيانات ChartPlotArea. الخصائص التي يمكن تعيينها هي:

عيّن الخيارات الأساسية للمحور الأفقي والعمودي حسب XAxis و YAxis.

خصائص XAxis التي يمكن تعيينها هي:

خصائص YAxis التي يمكن تعيينها هي:

قيمة TextRotation التي يمكن ضبطها من -90 إلى 90.

القيمة التي يمكن تعيينها لـ Vertical هي: horz، vert، vert270، wordArtVert، eaVert، mongolianVert و wordArtVertRtl.

عيِّن حجم الرسم البياني حسب خاصية Dimension. خاصية البعد اختيارية. الخصائص التي يمكن تعيينها هي:

تحدد المعلمة combo إنشاء مخطط يجمع بين نوعين أو أكثر من أنواع المخططات في مخطط واحد. على سبيل المثال ، أنشئ مخططًا خطيًا متفاوت المسافات يحتوي على البيانات Sheet1!$E$1:$L$15:

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    if err := f.SetSheetName("Sheet1", "ورقة1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "تفاح", "برتقال", "كمثرى"},
        {"صغير", 2, 3, 3},
        {"عادي", 5, 2, 4},
        {"كبير", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("ورقة1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.SetSheetView("ورقة1", -1, &excelize.ViewOptions{
        RightToLeft: &enable,
    }); err != nil {
        fmt.Println(err)
    }
    if err := f.AddChart("ورقة1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "ورقة1!$A$2",
                Categories: "ورقة1!$B$1:$D$1",
                Values:     "ورقة1!$B$2:$D$2",
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Title: excelize.ChartTitle{
            Paragraph: []excelize.RichTextRun{
                {
                    Text: "عمود متفاوت المسافات - تخطيط خطي",
                },
            },
        },
        Legend: excelize.ChartLegend{
            Position: "left",
        },
        PlotArea: excelize.ChartPlotArea{
            ShowCatName:     false,
            ShowLeaderLines: false,
            ShowPercent:     true,
            ShowSerName:     true,
            ShowVal:         true,
        },
    }, &excelize.Chart{
        Type: excelize.Line,
        Series: []excelize.ChartSeries{
            {
                Name:       "ورقة1!$A$4",
                Categories: "ورقة1!$B$1:$D$1",
                Values:     "ورقة1!$B$4:$D$4",
                Marker: excelize.ChartMarker{
                    Symbol: "none", Size: 10,
                },
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Legend: excelize.ChartLegend{
            Position: "right",
        },
        PlotArea: excelize.ChartPlotArea{
            ShowCatName:     false,
            ShowLeaderLines: false,
            ShowPercent:     true,
            ShowSerName:     true,
            ShowVal:         true,
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    // احفظ جدول البيانات بالمسار المحدد.
    if err := f.SaveAs("المصنف1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

أضف ورقة عمل المخطط

func (f *File) AddChartSheet(sheet string, chart *ChartOptions, combo ...*ChartOptions) error

توفر AddChartSheet طريقة لإنشاء ورقة مخطط من خلال مجموعة تنسيق مخطط معينة (مثل الإزاحة والمقياس وإعداد نسبة العرض إلى الارتفاع وإعدادات الطباعة) ومجموعة الخصائص. في Excel ، ورقة المخطط هي ورقة عمل تحتوي فقط على مخطط.

حذف مخطط

func (f *File) DeleteChart(sheet, cell string) error

يوفر DeleteChart وظيفة لحذف المخططات في جدول بيانات عن طريق اسم الخلية وورقة العمل المحددة.