Class SparklineGroup

Class SparklineGroup

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

Aspose.Cells.Charts.Sparkline به گروه اسپارکلاین سازماندهی شده است. یک SparklineGroup شامل تعداد متغیری از موارد اسپارکلاین است.
یک گروه اسپارکلاین نوع، تنظیمات نمایش و تنظیمات محور برای اسپارکلاین‌ها را مشخص می‌کند.

public class SparklineGroup

وراثت

objectSparklineGroup

اعضای وراثت‌یافته

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; }

مقدار ویژگی

bool

FirstPointColor

رنگ اولین نقطه داده در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor FirstPointColor { get; set; }

مقدار ویژگی

CellsColor

HighPointColor

رنگ بالاترین نقاط داده در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor HighPointColor { get; set; }

مقدار ویژگی

CellsColor

HorizontalAxisColor

رنگ محور افقی در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor HorizontalAxisColor { get; set; }

مقدار ویژگی

CellsColor

HorizontalAxisDateRange

محدوده‌ای را نشان می‌دهد که شامل مقادیر تاریخ برای داده‌های اسپارکلاین است.

public string HorizontalAxisDateRange { get; set; }

مقدار ویژگی

string

LastPointColor

رنگ آخرین نقطه داده در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor LastPointColor { get; set; }

مقدار ویژگی

CellsColor

LineWeight

وزن خط در هر خط اسپارکلاین در گروه اسپارکلاین را به واحد نقاط دریافت و تنظیم می‌کند.

public double LineWeight { get; set; }

مقدار ویژگی

double

LowPointColor

رنگ پایین‌ترین نقاط داده در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor LowPointColor { get; set; }

مقدار ویژگی

CellsColor

MarkersColor

رنگ نقاط در هر خط اسپارکلاین در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor MarkersColor { get; set; }

مقدار ویژگی

CellsColor

NegativePointsColor

رنگ مقادیر منفی در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor NegativePointsColor { get; set; }

مقدار ویژگی

CellsColor

PlotEmptyCellsType

مشخص می‌کند که چگونه سلول‌های خالی ترسیم شوند.

public PlotEmptyCellsType PlotEmptyCellsType { get; set; }

مقدار ویژگی

PlotEmptyCellsType

PlotRightToLeft

مشخص می‌کند که آیا داده‌های ترسیم شده از راست به چپ است یا خیر.

public bool PlotRightToLeft { get; set; }

مقدار ویژگی

bool

PresetStyle

نوع سبک پیش‌تنظیم گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public SparklinePresetStyleType PresetStyle { get; set; }

مقدار ویژگی

SparklinePresetStyleType

SeriesColor

رنگ اسپارکلاین‌ها در گروه اسپارکلاین را دریافت و تنظیم می‌کند.

public CellsColor SeriesColor { get; set; }

مقدار ویژگی

CellsColor

ShowFirstPoint

مشخص می‌کند که آیا باید اولین نقطه داده در گروه اسپارکلاین هایلایت شود یا خیر.

public bool ShowFirstPoint { get; set; }

مقدار ویژگی

bool

ShowHighPoint

مشخص می‌کند که آیا باید بالاترین نقاط داده در گروه اسپارکلاین هایلایت شود یا خیر.

public bool ShowHighPoint { get; set; }

مقدار ویژگی

bool

ShowHorizontalAxis

مشخص می‌کند که آیا محور افقی اسپارکلاین نمایش داده شود یا خیر.
محور افقی در صورتی ظاهر می‌شود که اسپارکلاین داده‌ای داشته باشد که محور صفر را قطع کند.

public bool ShowHorizontalAxis { get; set; }

مقدار ویژگی

bool

ShowLastPoint

مشخص می‌کند که آیا باید آخرین نقطه داده در گروه اسپارکلاین هایلایت شود یا خیر.

public bool ShowLastPoint { get; set; }

مقدار ویژگی

bool

ShowLowPoint

مشخص می‌کند که آیا باید پایین‌ترین نقاط داده در گروه اسپارکلاین هایلایت شود یا خیر.

public bool ShowLowPoint { get; set; }

مقدار ویژگی

bool

ShowMarkers

مشخص می‌کند که آیا باید هر نقطه در هر خط اسپارکلاین در گروه اسپارکلاین هایلایت شود یا خیر.

public bool ShowMarkers { get; set; }

مقدار ویژگی

bool

ShowNegativePoints

مشخص می‌کند که آیا باید مقادیر منفی در گروه اسپارکلاین با رنگ یا نشانگر متفاوت هایلایت شود یا خیر.

public bool ShowNegativePoints { get; set; }

مقدار ویژگی

bool

Sparklines

مجموعه‌ای از اشیاء Aspose.Cells.Charts.Sparkline را دریافت می‌کند.

public SparklineCollection Sparklines { get; }

مقدار ویژگی

SparklineCollection

Type

نوع اسپارکلاین گروه اسپارکلاین را مشخص می‌کند.

public SparklineType Type { get; set; }

مقدار ویژگی

SparklineType

VerticalAxisMaxValue

حداکثر مقدار سفارشی برای محور عمودی را دریافت و تنظیم می‌کند.

public double VerticalAxisMaxValue { get; set; }

مقدار ویژگی

double

VerticalAxisMaxValueType

نوع حداکثر مقدار محور عمودی را نشان می‌دهد.

public SparklineAxisMinMaxType VerticalAxisMaxValueType { get; set; }

مقدار ویژگی

SparklineAxisMinMaxType

VerticalAxisMinValue

حداقل مقدار سفارشی برای محور عمودی را دریافت و تنظیم می‌کند.

public double VerticalAxisMinValue { get; set; }

مقدار ویژگی

double

VerticalAxisMinValueType

نوع حداقل مقدار محور عمودی را نشان می‌دهد.

public SparklineAxisMinMaxType VerticalAxisMinValueType { get; set; }

مقدار ویژگی

SparklineAxisMinMaxType

متدها

ResetRanges(string, bool, CellArea)

محدوده داده و محدوده موقعیت گروه اسپارکلاین را بازنشانی می‌کند.
این متد موارد اسپارکلاین اصلی در گروه را پاک کرده و موارد اسپارکلاین جدیدی برای محدوده‌های جدید ایجاد می‌کند.

public void ResetRanges(string dataRange, bool isVertical, CellArea locationRange)

پارامترها

dataRange string

محدوده داده جدید گروه اسپارکلاین را مشخص می‌کند.

isVertical bool

مشخص می‌کند که آیا اسپارکلاین‌ها از محدوده داده جدید به صورت ردیفی یا ستونی ترسیم شوند.

locationRange CellArea

مشخص می‌کند که اسپارکلاین‌ها در کجا قرار بگیرند.

 فارسی