Class SparklineGroup
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Aspose.Cells.Charts.Sparkline به گروه اسپارکلاین سازماندهی شده است. یک SparklineGroup شامل تعداد متغیری از موارد اسپارکلاین است.
یک گروه اسپارکلاین نوع، تنظیمات نمایش و تنظیمات محور برای اسپارکلاینها را مشخص میکند.
public class SparklineGroup
وراثت
اعضای وراثتیافته
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
مثالها
Workbook book = new Workbook();
Worksheet sheet = book.Worksheets[0];
sheet.Cells["A1"].PutValue(5);
sheet.Cells["B1"].PutValue(2);
sheet.Cells["C1"].PutValue(1);
sheet.Cells["D1"].PutValue(3);
// تعریف CellArea
CellArea ca = new CellArea();
ca.StartColumn = 4;
ca.EndColumn = 4;
ca.StartRow = 0;
ca.EndRow = 0;
int idx = sheet.SparklineGroups.Add(Aspose.Cells.Charts.SparklineType.Line, "A1:D1", false, ca);
SparklineGroup group = sheet.SparklineGroups[idx];
group.Sparklines.Add(sheet.Name + "!A1:D1", 0, 4);
// ایجاد CellsColor
CellsColor clr = book.CreateCellsColor();
clr.Color = Color.Orange;
group.SeriesColor = clr;
// نقاط بالا به رنگ سبز و نقاط پایین به رنگ قرمز رنگآمیزی شوند
group.ShowHighPoint = true;
group.ShowLowPoint = true;
group.HighPointColor.Color = Color.Green;
group.LowPointColor.Color = Color.Red;
// تنظیم وزن خط
group.LineWeight = 1.0;
book.Save("output.xlsx", SaveFormat.Xlsx);
ویژگیها
DisplayHidden
مشخص میکند که آیا دادهها در ردیفها و ستونهای مخفی نمایش داده شوند یا خیر.
public bool DisplayHidden { get; set; }
مقدار ویژگی
FirstPointColor
رنگ اولین نقطه داده در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor FirstPointColor { get; set; }
مقدار ویژگی
HighPointColor
رنگ بالاترین نقاط داده در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor HighPointColor { get; set; }
مقدار ویژگی
HorizontalAxisColor
رنگ محور افقی در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor HorizontalAxisColor { get; set; }
مقدار ویژگی
HorizontalAxisDateRange
محدودهای را نشان میدهد که شامل مقادیر تاریخ برای دادههای اسپارکلاین است.
public string HorizontalAxisDateRange { get; set; }
مقدار ویژگی
LastPointColor
رنگ آخرین نقطه داده در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor LastPointColor { get; set; }
مقدار ویژگی
LineWeight
وزن خط در هر خط اسپارکلاین در گروه اسپارکلاین را به واحد نقاط دریافت و تنظیم میکند.
public double LineWeight { get; set; }
مقدار ویژگی
LowPointColor
رنگ پایینترین نقاط داده در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor LowPointColor { get; set; }
مقدار ویژگی
MarkersColor
رنگ نقاط در هر خط اسپارکلاین در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor MarkersColor { get; set; }
مقدار ویژگی
NegativePointsColor
رنگ مقادیر منفی در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor NegativePointsColor { get; set; }
مقدار ویژگی
PlotEmptyCellsType
مشخص میکند که چگونه سلولهای خالی ترسیم شوند.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }
مقدار ویژگی
PlotRightToLeft
مشخص میکند که آیا دادههای ترسیم شده از راست به چپ است یا خیر.
public bool PlotRightToLeft { get; set; }
مقدار ویژگی
PresetStyle
نوع سبک پیشتنظیم گروه اسپارکلاین را دریافت و تنظیم میکند.
public SparklinePresetStyleType PresetStyle { get; set; }
مقدار ویژگی
SeriesColor
رنگ اسپارکلاینها در گروه اسپارکلاین را دریافت و تنظیم میکند.
public CellsColor SeriesColor { get; set; }
مقدار ویژگی
ShowFirstPoint
مشخص میکند که آیا باید اولین نقطه داده در گروه اسپارکلاین هایلایت شود یا خیر.
public bool ShowFirstPoint { get; set; }
مقدار ویژگی
ShowHighPoint
مشخص میکند که آیا باید بالاترین نقاط داده در گروه اسپارکلاین هایلایت شود یا خیر.
public bool ShowHighPoint { get; set; }
مقدار ویژگی
ShowHorizontalAxis
مشخص میکند که آیا محور افقی اسپارکلاین نمایش داده شود یا خیر.
محور افقی در صورتی ظاهر میشود که اسپارکلاین دادهای داشته باشد که محور صفر را قطع کند.
public bool ShowHorizontalAxis { get; set; }
مقدار ویژگی
ShowLastPoint
مشخص میکند که آیا باید آخرین نقطه داده در گروه اسپارکلاین هایلایت شود یا خیر.
public bool ShowLastPoint { get; set; }
مقدار ویژگی
ShowLowPoint
مشخص میکند که آیا باید پایینترین نقاط داده در گروه اسپارکلاین هایلایت شود یا خیر.
public bool ShowLowPoint { get; set; }
مقدار ویژگی
ShowMarkers
مشخص میکند که آیا باید هر نقطه در هر خط اسپارکلاین در گروه اسپارکلاین هایلایت شود یا خیر.
public bool ShowMarkers { get; set; }
مقدار ویژگی
ShowNegativePoints
مشخص میکند که آیا باید مقادیر منفی در گروه اسپارکلاین با رنگ یا نشانگر متفاوت هایلایت شود یا خیر.
public bool ShowNegativePoints { get; set; }
مقدار ویژگی
Sparklines
مجموعهای از اشیاء Aspose.Cells.Charts.Sparkline را دریافت میکند.
public SparklineCollection Sparklines { get; }
مقدار ویژگی
Type
نوع اسپارکلاین گروه اسپارکلاین را مشخص میکند.
public SparklineType Type { get; set; }
مقدار ویژگی
VerticalAxisMaxValue
حداکثر مقدار سفارشی برای محور عمودی را دریافت و تنظیم میکند.
public double VerticalAxisMaxValue { get; set; }
مقدار ویژگی
VerticalAxisMaxValueType
نوع حداکثر مقدار محور عمودی را نشان میدهد.
public SparklineAxisMinMaxType VerticalAxisMaxValueType { get; set; }
مقدار ویژگی
VerticalAxisMinValue
حداقل مقدار سفارشی برای محور عمودی را دریافت و تنظیم میکند.
public double VerticalAxisMinValue { get; set; }
مقدار ویژگی
VerticalAxisMinValueType
نوع حداقل مقدار محور عمودی را نشان میدهد.
public SparklineAxisMinMaxType VerticalAxisMinValueType { get; set; }
مقدار ویژگی
متدها
ResetRanges(string, bool, CellArea)
محدوده داده و محدوده موقعیت گروه اسپارکلاین را بازنشانی میکند.
این متد موارد اسپارکلاین اصلی در گروه را پاک کرده و موارد اسپارکلاین جدیدی برای محدودههای جدید ایجاد میکند.
public void ResetRanges(string dataRange, bool isVertical, CellArea locationRange)
پارامترها
dataRange
string
محدوده داده جدید گروه اسپارکلاین را مشخص میکند.
isVertical
bool
مشخص میکند که آیا اسپارکلاینها از محدوده داده جدید به صورت ردیفی یا ستونی ترسیم شوند.
locationRange
CellArea
مشخص میکند که اسپارکلاینها در کجا قرار بگیرند.