Class Trendline
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
يمثل خط الاتجاه في الرسم البياني.
public class Trendline : Line
الوراثة
الأعضاء الموروثة
Line.m_lineParent, Line.CompoundType, Line.DashType, Line.CapType, Line.JoinType, Line.BeginType, Line.EndType, Line.BeginArrowLength, Line.EndArrowLength, Line.BeginArrowWidth, Line.EndArrowWidth, Line.ThemeColor, Line.Color, Line.Transparency, Line.Style, Line.Weight, Line.WeightPt, Line.WeightPx, Line.FormattingType, Line.IsAutomaticColor, Line.IsVisible, Line.IsAuto, Line.GradientFill, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
أمثلة
//إنشاء كائن Workbook
Workbook workbook = new Workbook();
//إضافة ورقة عمل جديدة إلى كائن Excel
int sheetIndex = workbook.Worksheets.Add();
//الحصول على مرجع ورقة العمل الجديدة المضافة عن طريق تمرير فهرس الورقة
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//إضافة قيمة عينة إلى الخلية "A1"
worksheet.Cells["A1"].PutValue(50);
//إضافة قيمة عينة إلى الخلية "A2"
worksheet.Cells["A2"].PutValue(100);
//إضافة قيمة عينة إلى الخلية "A3"
worksheet.Cells["A3"].PutValue(150);
//إضافة قيمة عينة إلى الخلية "A4"
worksheet.Cells["A4"].PutValue(200);
//إضافة قيمة عينة إلى الخلية "B1"
worksheet.Cells["B1"].PutValue(60);
//إضافة قيمة عينة إلى الخلية "B2"
worksheet.Cells["B2"].PutValue(32);
//إضافة قيمة عينة إلى الخلية "B3"
worksheet.Cells["B3"].PutValue(50);
//إضافة قيمة عينة إلى الخلية "B4"
worksheet.Cells["B4"].PutValue(40);
//إضافة قيمة عينة إلى الخلية "C1" كبيانات فئة
worksheet.Cells["C1"].PutValue("Q1");
//إضافة قيمة عينة إلى الخلية "C2" كبيانات فئة
worksheet.Cells["C2"].PutValue("Q2");
//إضافة قيمة عينة إلى الخلية "C3" كبيانات فئة
worksheet.Cells["C3"].PutValue("Y1");
//إضافة قيمة عينة إلى الخلية "C4" كبيانات فئة
worksheet.Cells["C4"].PutValue("Y2");
//إضافة رسم بياني إلى ورقة العمل
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//الوصول إلى مثيل الرسم البياني الجديد المضاف
Chart chart = worksheet.Charts[chartIndex];
//إضافة NSeries (مصدر بيانات الرسم البياني) إلى الرسم البياني من الخلية "A1" إلى "B4"
chart.NSeries.Add("A1:B4", true);
//تعيين مصدر البيانات لبيانات الفئة لـ NSeries
chart.NSeries.CategoryData = "C1:C4";
//إضافة خط اتجاه خطي
int index = chart.NSeries[0].TrendLines.Add(TrendlineType.Linear);
Trendline trendline = chart.NSeries[0].TrendLines[index];
//تعيين الاسم المخصص لخط الاتجاه.
trendline.Name = "Linear";
//عرض المعادلة على الرسم البياني
trendline.DisplayEquation = true;
//عرض قيمة R-Squared على الرسم البياني
trendline.DisplayRSquared = true;
//حفظ ملف Excel
workbook.Save("book1.xls");
'إنشاء كائن Workbook
Dim workbook As Workbook = New Workbook()
'إضافة ورقة عمل جديدة إلى كائن Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'الحصول على مرجع ورقة العمل الجديدة المضافة عن طريق تمرير فهرس الورقة
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'إضافة قيمة عينة إلى الخلية "A1"
worksheet.Cells("A1").PutValue(50)
'إضافة قيمة عينة إلى الخلية "A2"
worksheet.Cells("A2").PutValue(100)
'إضافة قيمة عينة إلى الخلية "A3"
worksheet.Cells("A3").PutValue(150)
'إضافة قيمة عينة إلى الخلية "A4"
worksheet.Cells("A4").PutValue(200)
'إضافة قيمة عينة إلى الخلية "B1"
worksheet.Cells("B1").PutValue(60)
'إضافة قيمة عينة إلى الخلية "B2"
worksheet.Cells("B2").PutValue(32)
'إضافة قيمة عينة إلى الخلية "B3"
worksheet.Cells("B3").PutValue(50)
'إضافة قيمة عينة إلى الخلية "B4"
worksheet.Cells("B4").PutValue(40)
'إضافة قيمة عينة إلى الخلية "C1" كبيانات فئة
worksheet.Cells("C1").PutValue("Q1")
'إضافة قيمة عينة إلى الخلية "C2" كبيانات فئة
worksheet.Cells("C2").PutValue("Q2")
'إضافة قيمة عينة إلى الخلية "C3" كبيانات فئة
worksheet.Cells("C3").PutValue("Y1")
'إضافة قيمة عينة إلى الخلية "C4" كبيانات فئة
worksheet.Cells("C4").PutValue("Y2")
'إضافة رسم بياني إلى ورقة العمل
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'الوصول إلى مثيل الرسم البياني الجديد المضاف
Dim chart As Chart = worksheet.Charts(chartIndex)
'إضافة NSeries (مصدر بيانات الرسم البياني) إلى الرسم البياني من الخلية "A1" إلى "B4"
chart.NSeries.Add("A1:B4", True)
'تعيين مصدر البيانات لبيانات الفئة لـ NSeries
Chart.NSeries.CategoryData = "C1:C4"
'إضافة خط اتجاه خطي
Dim index As Int32 = chart.NSeries(0).TrendLines.Add(TrendlineType.Linear)
Dim trendline As Trendline = chart.NSeries(0).TrendLines(index)
'تعيين الاسم المخصص لخط الاتجاه.
trendline.Name = "Linear"
'عرض المعادلة على الرسم البياني
trendline.DisplayEquation = True
'عرض قيمة R-Squared على الرسم البياني
trendline.DisplayRSquared = True
'حفظ ملف Excel
workbook.Save("book1.xls")
الخصائص
Backward
يرجع أو يحدد عدد الفترات (أو الوحدات في الرسم البياني المتناثر) التي يمتد فيها خط الاتجاه للخلف. يجب أن يكون عدد الفترات أكبر من أو يساوي صفر. إذا كان نوع الرسم البياني هو عمودي، يجب أن يكون عدد الفترات بين 0 و 0.5
public double Backward { get; set; }
قيمة الخاصية
DataLabels
يمثل كائن DataLabels للسلسلة المحددة.
public DataLabels DataLabels { get; }
قيمة الخاصية
DisplayEquation
يمثل ما إذا كانت المعادلة لخط الاتجاه معروضة على الرسم البياني (في نفس تسمية البيانات مثل قيمة R-squared). تعيين هذه الخاصية إلى True يقوم تلقائيًا بتشغيل تسميات البيانات.
public bool DisplayEquation { get; set; }
قيمة الخاصية
DisplayRSquared
يمثل ما إذا كانت قيمة R-squared لخط الاتجاه معروضة على الرسم البياني (في نفس تسمية البيانات مثل المعادلة). تعيين هذه الخاصية إلى True يقوم تلقائيًا بتشغيل تسميات البيانات.
public bool DisplayRSquared { get; set; }
قيمة الخاصية
Forward
يرجع أو يحدد عدد الفترات (أو الوحدات في الرسم البياني المتناثر) التي يمتد فيها خط الاتجاه للأمام. يجب أن يكون عدد الفترات أكبر من أو يساوي صفر.
public double Forward { get; set; }
قيمة الخاصية
Intercept
يرجع أو يحدد النقطة التي يعبر فيها خط الاتجاه محور القيم.
public double Intercept { get; set; }
قيمة الخاصية
IsNameAuto
يرجع ما إذا كان Microsoft Excel يحدد تلقائيًا اسم خط الاتجاه.
public bool IsNameAuto { get; set; }
قيمة الخاصية
LegendEntry
يحصل على إدخال الأسطورة وفقًا لهذا الخط الاتجاه
public LegendEntry LegendEntry { get; }
قيمة الخاصية
Name
يرجع اسم خط الاتجاه.
public string Name { get; set; }
قيمة الخاصية
Order
يرجع أو يحدد ترتيب خط الاتجاه (عدد صحيح أكبر من 1) عندما يكون نوع خط الاتجاه هو متعدد الحدود. يجب أن يكون الترتيب بين 2 و 6.
public int Order { get; set; }
قيمة الخاصية
Period
يرجع أو يحدد الفترة لخط الاتجاه المتوسط المتحرك.
public int Period { get; set; }
ملاحظات
يجب أن تكون هذه القيمة بين 2 و 255. ويجب أن تكون أقل من عدد نقاط الرسم البياني في السلسلة
Type
يرجع نوع خط الاتجاه.
public TrendlineType Type { get; }