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 = "ליניארי";
//הצגת המשוואה על הגרף
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 = "ליניארי"
'הצגת המשוואה על הגרף
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; }