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?text=+area.

public Area Area { get; }

ערך המאפיין

Area

Border

מקבל את Aspose.Cells.Drawing.Line?text=+border.

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?text=+marker.

public Marker Marker { get; }

ערך המאפיין

Marker

RadiusPx

מקבל את הרדיוס של בועה, פאי או דונאט ביחידות של פיקסלים לאחר קריאות לשיטת Chart.Calculate().

public int RadiusPx { get; }

ערך המאפיין

int

Shadow

נכון אם לנקודת הגרף יש צל.

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 שמחזיק את המאפיינים הוויזואליים של נקודת הגרף.

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(). חל על גרפים תלת-ממדיים: Column3D, Bar3D, Cone, Cylinder, Pyramid

public float GetBottomPointXPx(int index)

פרמטרים

index int

מחזיר

float

GetBottomPointYPx(int)

מקבל את הקואורדינטה y של הנקודה התחתונה של הצורה לאחר קריאות לשיטת Chart.Calculate(). חל על גרפים תלת-ממדיים: Column3D, Bar3D, Cone, Cylinder, Pyramid

public float GetBottomPointYPx(int index)

פרמטרים

index int

מחזיר

float

GetOnCategoryAxisPointCount()

מקבל את מספר הנקודות על ציר הקטגוריה לאחר קריאות לשיטת Chart.Calculate(). חל רק על גרף שטח.

public int GetOnCategoryAxisPointCount()

מחזיר

int

הערות

גרף שטח דו-ממדי מחזיר 1
גרף שטח תלת-ממדי מחזיר 2.

GetOnCategoryAxisPointXPx(int)

מקבל את הקואורדינטה x של הנקודה על ציר הקטגוריה לאחר קריאות לשיטת Chart.Calculate(). חל רק על גרף שטח.

public float GetOnCategoryAxisPointXPx(int index)

פרמטרים

index int

מחזיר

float

הערות

גרף שטח דו-ממדי: index הוא 0.
גרף שטח תלת-ממדי: index הוא 0 או 1.

GetOnCategoryAxisPointYPx(int)

מקבל את הקואורדינטה y של הנקודה על ציר הקטגוריה לאחר קריאות לשיטת Chart.Calculate(). חל רק על גרף שטח.

public float GetOnCategoryAxisPointYPx(int index)

פרמטרים

index int

מחזיר

float

הערות

גרף שטח דו-ממדי: index הוא 0.
גרף שטח תלת-ממדי: index הוא 0 או 1.

GetTopPointCount()

מקבל את מספר הנקודות העליונות לאחר קריאות לשיטת Chart.Calculate().

public int GetTopPointCount()

מחזיר

int

GetTopPointXPx(int)

מקבל את הקואורדינטה x של הנקודה העליונה של הצורה לאחר קריאות לשיטת Chart.Calculate(). חל על גרפים תלת-ממדיים: Column3D, Bar3D, Cone, Cylinder, Pyramid ו- Area3D

public float GetTopPointXPx(int index)

פרמטרים

index int

מחזיר

float

GetTopPointYPx(int)

מקבל את הקואורדינטה y של הנקודה העליונה של הצורה לאחר קריאות לשיטת Chart.Calculate(). חל על גרפים תלת-ממדיים: Column3D, Bar3D, Cone, Cylinder, Pyramid ו- Area3D

public float GetTopPointYPx(int index)

פרמטרים

index int

מחזיר

float