Class ChartPoint

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

نمایانگر یک نقطه واحد در یک سری در یک نمودار است.

public class ChartPoint

وراثت

object ← ChartPoint

اعضای وراثتی

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

مثال‌ها

//ایجاد یک شی Workbook
Workbook workbook = new Workbook();

//دریافت مرجع اولین ورق کار
Worksheet worksheet = workbook.Worksheets[0];

//اضافه کردن یک مقدار نمونه به سلول "A1"
worksheet.Cells["A1"].PutValue(50);

//اضافه کردن یک مقدار نمونه به سلول "A2"
worksheet.Cells["A2"].PutValue(100);

//اضافه کردن یک مقدار نمونه به سلول "A3"
worksheet.Cells["A3"].PutValue(150);

//اضافه کردن یک مقدار نمونه به سلول "B1"
worksheet.Cells["B1"].PutValue(60);

//اضافه کردن یک مقدار نمونه به سلول "B2"
worksheet.Cells["B2"].PutValue(32);

//اضافه کردن یک مقدار نمونه به سلول "B3"
worksheet.Cells["B3"].PutValue(50);

//اضافه کردن یک نمودار به ورق کار
int chartIndex = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10);

//دسترسی به نمونه نمودار تازه اضافه شده
Chart chart = worksheet.Charts[chartIndex];

//اضافه کردن NSeries (منبع داده نمودار) به نمودار از سلول "A1" تا "B3"
chart.NSeries.Add("A1:B3", true);

//نمایش برچسب‌های داده
chart.NSeries[0].DataLabels.ShowValue = true;

for (int i = 0; i < chart.NSeries[0].Points.Count; i++)
{
    //دریافت نقطه داده
    ChartPoint point = chart.NSeries[0].Points[i];
    //تنظیم انفجار پای
    point.Explosion = 15;
    //تنظیم رنگ مرز
    point.Border.Color = System.Drawing.Color.Red;
}

//ذخیره فایل اکسل
workbook.Save("book1.xls");

'ایجاد یک شی Workbook
Dim workbook As Workbook = New Workbook()

'دریافت مرجع اولین ورق کار
Dim worksheet As Worksheet = workbook.Worksheets(0)

'اضافه کردن یک مقدار نمونه به سلول "A1"
worksheet.Cells("A1").PutValue(50)

'اضافه کردن یک مقدار نمونه به سلول "A2"
worksheet.Cells("A2").PutValue(100)

'اضافه کردن یک مقدار نمونه به سلول "A3"
worksheet.Cells("A3").PutValue(150)

'اضافه کردن یک مقدار نمونه به سلول "B1"
worksheet.Cells("B1").PutValue(60)

'اضافه کردن یک مقدار نمونه به سلول "B2"
worksheet.Cells("B2").PutValue(32)

'اضافه کردن یک مقدار نمونه به سلول "B3"
worksheet.Cells("B3").PutValue(50)

'اضافه کردن یک نمودار به ورق کار
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10)

'دسترسی به نمونه نمودار تازه اضافه شده
Dim chart As Chart = worksheet.Charts(chartIndex)

'اضافه کردن NSeries (منبع داده نمودار) به نمودار از سلول "A1" تا "B3"
chart.NSeries.Add("A1:B3", True)

'نمایش برچسب‌های داده
chart.NSeries(0).DataLabels.IsValueShown = True

For i As Integer = 0 To chart.NSeries(0).Points.Count - 1
    'دریافت نقطه داده
    Dim point As ChartPoint = chart.NSeries(0).Points(i)
    'تنظیم انفجار پای
    point.Explosion = 15
    'تنظیم رنگ مرز
    point.Border.Color = System.Drawing.Color.Red
Next i

'ذخیره فایل اکسل
workbook.Save("book1.xls")

ویژگی‌ها

ArcEndPointXPx

مختصات x نقطه انتهایی برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار پای و دونات اعمال می‌شود.

public float ArcEndPointXPx { get; }

مقدار ویژگی

float

ArcEndPointYPx

مختصات y نقطه انتهایی برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار پای و دونات اعمال می‌شود.

public float ArcEndPointYPx { get; }

مقدار ویژگی

float

ArcStartPointXPx

مختصات x نقطه شروع برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار پای و دونات اعمال می‌شود.

public float ArcStartPointXPx { get; }

مقدار ویژگی

float

ArcStartPointYPx

مختصات y نقطه شروع برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار پای و دونات اعمال می‌شود.

public float ArcStartPointYPx { get; }

مقدار ویژگی

float

Area

مساحت Aspose.Cells.Charts.ChartPoint.Area را دریافت می‌کند.

public Area Area { get; }

مقدار ویژگی

Area

Border

خط Aspose.Cells.Drawing.Line را دریافت می‌کند.

public Line Border { get; }

مقدار ویژگی

Line

BorderWidthPx

عرض مرز را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int BorderWidthPx { get; }

مقدار ویژگی

int

DataLabels

یک شی Aspose.Cells.Charts.ChartPoint.DataLabels را که نمایانگر برچسب داده مرتبط با این نقطه نمودار است، برمی‌گرداند.

public DataLabels DataLabels { get; }

مقدار ویژگی

DataLabels

DoughnutInnerRadius

شعاع داخلی برش دونات را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار دونات اعمال می‌شود.

public int DoughnutInnerRadius { get; }

مقدار ویژگی

int

EndAngle

زاویه انتهایی برای بخش پای را که به درجه از محور x اندازه‌گیری می‌شود پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار پای اعمال می‌شود.

public float EndAngle { get; }

مقدار ویژگی

float

Explosion

فاصله یک برش پای باز از مرکز نمودار پای به صورت درصدی از قطر پای بیان می‌شود.

public int Explosion { get; set; }

مقدار ویژگی

int

InnerArcEndPointXPx

مختصات x نقطه انتهایی برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار دونات اعمال می‌شود.

public float InnerArcEndPointXPx { get; }

مقدار ویژگی

float

InnerArcEndPointYPx

مختصات y نقطه انتهایی برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار دونات اعمال می‌شود.

public float InnerArcEndPointYPx { get; }

مقدار ویژگی

float

InnerArcStartPointXPx

مختصات x نقطه شروع برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار دونات اعمال می‌شود.

public float InnerArcStartPointXPx { get; }

مقدار ویژگی

float

InnerArcStartPointYPx

مختصات y نقطه شروع برای بخش پای را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار دونات اعمال می‌شود.

public float InnerArcStartPointYPx { get; }

مقدار ویژگی

float

IsInSecondaryPlot

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

public bool IsInSecondaryPlot { get; set; }

مقدار ویژگی

bool

Marker

شی Aspose.Cells.Charts.ChartPoint.Marker را دریافت می‌کند.

public Marker Marker { get; }

مقدار ویژگی

Marker

RadiusPx

شعاع حباب، پای یا دونات را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int RadiusPx { get; }

مقدار ویژگی

int

Shadow

اگر نقطه نمودار سایه داشته باشد، مقدار True را برمی‌گرداند.

public bool Shadow { get; set; }

مقدار ویژگی

bool

ShapeHeight

ارتفاع را به واحد 1/4000 از ارتفاع نمودار پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeHeight { get; }

مقدار ویژگی

int

ShapeHeightPx

ارتفاع را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeHeightPx { get; }

مقدار ویژگی

int

ShapeProperties

شی Aspose.Cells.Drawing.ShapePropertyCollection را که خواص بصری شکل ChartPoint را نگهداری می‌کند، دریافت می‌کند.

public ShapePropertyCollection ShapeProperties { get; }

مقدار ویژگی

ShapePropertyCollection

ShapeWidth

عرض را به واحد 1/4000 از عرض نمودار پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeWidth { get; }

مقدار ویژگی

int

ShapeWidthPx

عرض را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeWidthPx { get; }

مقدار ویژگی

int

ShapeX

مختصات x گوشه بالای سمت چپ را به واحد 1/4000 از عرض نمودار پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeX { get; }

مقدار ویژگی

int

ShapeXPx

مختصات x گوشه بالای سمت چپ را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeXPx { get; }

مقدار ویژگی

int

ShapeY

مختصات y گوشه بالای سمت چپ را به واحد 1/4000 از ارتفاع نمودار پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeY { get; }

مقدار ویژگی

int

ShapeYPx

مختصات y گوشه بالای سمت چپ را به واحد پیکسل پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int ShapeYPx { get; }

مقدار ویژگی

int

StartAngle

زاویه شروع برای بخش پای را که به درجه از محور x اندازه‌گیری می‌شود پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودار پای اعمال می‌شود.

public float StartAngle { get; }

مقدار ویژگی

float

XValue

مقدار X نقطه نمودار را دریافت یا تنظیم می‌کند.

public object XValue { get; set; }

مقدار ویژگی

object

XValueType

نوع مقدار X نقطه نمودار را دریافت می‌کند.

public CellValueType XValueType { get; }

مقدار ویژگی

CellValueType

YValue

مقدار Y نقطه نمودار را دریافت یا تنظیم می‌کند.

public object YValue { get; set; }

مقدار ویژگی

object

YValueType

نوع مقدار Y نقطه نمودار را دریافت می‌کند.

public CellValueType YValueType { get; }

مقدار ویژگی

CellValueType

متدها

GetBottomPointCount()

تعداد نقاط پایین را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int GetBottomPointCount()

برمی‌گرداند

int

GetBottomPointXPx(int)

مختصات x نقطه پایین شکل را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودارهای 3D: Column3D، Bar3D، Cone، Cylinder، Pyramid اعمال می‌شود.

public float GetBottomPointXPx(int index)

پارامترها

index int

برمی‌گرداند

float

GetBottomPointYPx(int)

مختصات y نقطه پایین شکل را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودارهای 3D: Column3D، Bar3D، Cone، Cylinder، Pyramid اعمال می‌شود.

public float GetBottomPointYPx(int index)

پارامترها

index int

برمی‌گرداند

float

GetOnCategoryAxisPointCount()

تعداد نقاط روی محور دسته را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. فقط به نمودار منطقه اعمال می‌شود.

public int GetOnCategoryAxisPointCount()

برمی‌گرداند

int

توضیحات

نمودار 2D منطقه 1 را برمی‌گرداند نمودار 3D منطقه 2 را برمی‌گرداند.

GetOnCategoryAxisPointXPx(int)

مختصات x نقطه روی محور دسته را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. فقط به نمودار منطقه اعمال می‌شود.

public float GetOnCategoryAxisPointXPx(int index)

پارامترها

index int

برمی‌گرداند

float

توضیحات

نمودار 2D منطقه: index برابر با 0 است. نمودار 3D منطقه: index برابر با 0 یا 1 است.

GetOnCategoryAxisPointYPx(int)

مختصات y نقطه روی محور دسته را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. فقط به نمودار منطقه اعمال می‌شود.

public float GetOnCategoryAxisPointYPx(int index)

پارامترها

index int

برمی‌گرداند

float

توضیحات

نمودار 2D منطقه: index برابر با 0 است. نمودار 3D منطقه: index برابر با 0 یا 1 است.

GetTopPointCount()

تعداد نقاط بالا را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند.

public int GetTopPointCount()

برمی‌گرداند

int

GetTopPointXPx(int)

مختصات x نقطه بالای شکل را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودارهای 3D: Column3D، Bar3D، Cone، Cylinder، Pyramid و Area3D اعمال می‌شود.

public float GetTopPointXPx(int index)

پارامترها

index int

برمی‌گرداند

float

GetTopPointYPx(int)

مختصات y نقطه بالای شکل را پس از فراخوانی متد Chart.Calculate() دریافت می‌کند. به نمودارهای 3D: Column3D، Bar3D، Cone، Cylinder، Pyramid و Area3D اعمال می‌شود.

public float GetTopPointYPx(int index)

پارامترها

index int

برمی‌گرداند

float