Class Axis
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
מכיל את האובייקט המייצג ציר של תרשים.
public class Axis
ירושה
חברים שהועברו
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);
//הוספת ערך לדוגמה לתא "B1"
worksheet.Cells["B1"].PutValue(4);
//הוספת ערך לדוגמה לתא "B2"
worksheet.Cells["B2"].PutValue(20);
//הוספת ערך לדוגמה לתא "B3"
worksheet.Cells["B3"].PutValue(50);
//הוספת תרשים לגיליון
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5);
//גישה לאינסטנציה של התרשים החדש שהוסף
Chart chart = worksheet.Charts[chartIndex];
//הוספת NSeries (מקור נתוני התרשים) לתרשים בטווח מתא "A1" עד "B3"
chart.NSeries.Add("A1:B3", true);
//הגדרת הערך המקסימלי של ציר הערך
chart.ValueAxis.MaxValue = 200;
//הגדרת הערך המינימלי של ציר הערך
chart.ValueAxis.MinValue = 0;
//הגדרת היחידה העיקרית
chart.ValueAxis.MajorUnit = 25;
//ציר הקטגוריה (X) חוצה בערך המקסימלי.
chart.ValueAxis.CrossType = CrossType.Maximum;
//הגדרת מספר הקטגוריות או הסדרות בין תוויות סימון.
chart.CategoryAxis.TickLabelSpacing = 2;
//בצע את העסקים שלך
//שמור את קובץ Excel
workbook.Save("book1.xlsx");
'יצירת אובייקט 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)
'הוספת ערך לדוגמה לתא "B1"
worksheet.Cells("B1").PutValue(4)
'הוספת ערך לדוגמה לתא "B2"
worksheet.Cells("B2").PutValue(20)
'הוספת ערך לדוגמה לתא "B3"
worksheet.Cells("B3").PutValue(50)
'הוספת תרשים לגיליון
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 25, 5)
'גישה לאינסטנציה של התרשים החדש שהוסף
Dim chart As Chart = worksheet.Charts(chartIndex)
'הוספת NSeries (מקור נתוני התרשים) לתרשים בטווח מתא "A1" עד "B3"
chart.NSeries.Add("A1:B3", True)
'הגדרת הערך המקסימלי של ציר הערך
chart.ValueAxis.MaxValue = 200
'הגדרת הערך המינימלי של ציר הערך
chart.ValueAxis.MinValue = 0
'הגדרת היחידה העיקרית
chart.ValueAxis.MajorUnit = 25
'ציר הקטגוריה (X) חוצה בערך המקסימלי.
chart.ValueAxis.CrossType = CrossType.Maximum
'הגדרת מספר הקטגוריות או הסדרות בין תוויות סימון.
chart.CategoryAxis.TickLabelSpacing = 2
'שמור את קובץ Excel
workbook.Save("book1.xlsx")
תכונות
אזור
מקבל את Aspose.Cells.Charts.Axis.Area.
public Area Area { get; }
ערך תכונה
AxisBetweenCategories
מייצג אם ציר הערך חוצה את ציר הקטגוריה בין קטגוריות.
public bool AxisBetweenCategories { get; set; }
ערך תכונה
הערות
תכונה זו חלה רק על צירי קטגוריה, והיא לא חלה על תרשימי תלת מימד.
AxisLine
מקבל את המראה של ציר.
public Line AxisLine { get; }
ערך תכונה
BaseUnitScale
מייצג את קנה המידה של יחידת הבסיס עבור ציר הקטגוריה.
public TimeUnit BaseUnitScale { get; set; }
ערך תכונה
הערות
הגדרת תכונה זו משפיעה רק כאשר תכונת CategoryType מוגדרת ל-TimeScale.
Bins
מייצג תיבות על ציר התרשים (היסטוגרמה/פרטו)
public AxisBins Bins { get; }
ערך תכונה
CategoryType
מייצג את סוג ציר הקטגוריה.
public CategoryType CategoryType { get; set; }
ערך תכונה
CrossAt
מייצג את הנקודה על ציר הערך שבה ציר הקטגוריה חוצה אותו.
public double CrossAt { get; set; }
ערך תכונה
הערות
המספר צריך להיות שלם כאשר הוא חל על ציר קטגוריה. והערך חייב להיות בין 1 ל-31999.
CrossType
מייצג את Aspose.Cells.Charts.Axis.CrossType על הציר המוגדר שבו הציר האחר חוצה.
public CrossType CrossType { get; set; }
ערך תכונה
CustomDisplayUnit
מפרט ערך מותאם אישית עבור יחידת התצוגה.
public double CustomDisplayUnit { get; set; }
ערך תכונה
DisplayUnit
מייצג את תווית היחידה עבור הציר המוגדר.
public DisplayUnitType DisplayUnit { get; set; }
ערך תכונה
DisplayUnitLabel
מייצג תווית יחידה על ציר בתרשים המוגדר. תוויות יחידה שימושיות עבור תרשימים עם ערכים גדולים— לדוגמה, במיליונים או ביליונים.
public DisplayUnitLabel DisplayUnitLabel { get; }
ערך תכונה
HasMultiLevelLabels
מציין אם התוויות יוצגו כרמות מרובות.
public bool HasMultiLevelLabels { get; set; }
ערך תכונה
הערות
רק תקף עבור ציר קטגוריה.
IsAutoTickLabelSpacing
מציין אם הרווח של תווית הסימון הוא אוטומטי
public bool IsAutoTickLabelSpacing { get; set; }
ערך תכונה
IsAutomaticMajorUnit
מציין אם היחידה העיקרית של הציר מוקצה אוטומטית.
public bool IsAutomaticMajorUnit { get; set; }
ערך תכונה
IsAutomaticMaxValue
מציין אם הערך המקסימלי מוקצה אוטומטית.
public bool IsAutomaticMaxValue { get; set; }
ערך תכונה
IsAutomaticMinValue
מציין אם הערך המינימלי מוקצה אוטומטית.
public bool IsAutomaticMinValue { get; set; }
ערך תכונה
IsAutomaticMinorUnit
מציין אם היחידה הקטנה של הציר מוקצה אוטומטית.
public bool IsAutomaticMinorUnit { get; set; }
ערך תכונה
IsDisplayUnitLabelShown
מייצג אם תווית יחידת התצוגה מוצגת על הציר המוגדר.
public bool IsDisplayUnitLabelShown { get; set; }
ערך תכונה
הערות
הערך ברירת המחדל הוא True.
IsLogarithmic
מייצג אם סוג קנה המידה של ציר הערך הוא לוגריתמי או לא.
public bool IsLogarithmic { get; set; }
ערך תכונה
IsPlotOrderReversed
מייצג אם Microsoft Excel מציב את נקודות הנתונים מהאחרון לראשון.
public bool IsPlotOrderReversed { get; set; }
ערך תכונה
IsVisible
מייצג אם הציר נראה.
public bool IsVisible { get; set; }
ערך תכונה
LogBase
מייצג את הבסיס הלוגריתמי. ערך ברירת המחדל הוא 10. חל רק על Excel2007.
public double LogBase { get; set; }
ערך תכונה
MajorGridLines
מייצג קווי רשת עיקריים על ציר התרשים.
public Line MajorGridLines { get; }
ערך תכונה
דוגמאות
chart.ValueAxis.MajorGridLines.IsVisible = false;
chart.CategoryAxis.MajorGridLines.IsVisible = true;
chart.ValueAxis.MajorGridLines.IsVisible = false
chart.CategoryAxis.MajorGridLines.IsVisible = true
MajorTickMark
מייצג את סוג סימן הסימון העיקרי עבור הציר המוגדר.
public TickMarkType MajorTickMark { get; set; }
ערך תכונה
MajorUnit
מייצג את היחידות העיקריות עבור הציר.
public double MajorUnit { get; set; }
ערך תכונה
הערות
היחידות העיקריות חייבות להיות גדולות מאפס.
MajorUnitScale
מייצג את קנה המידה של היחידה העיקרית עבור ציר הקטגוריה.
public TimeUnit MajorUnitScale { get; set; }
ערך תכונה
דוגמאות
chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MajorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MajorUnitScale = TimeUnit.Months
chart.CategoryAxis.MajorUnit = 2
MaxValue
מייצג את הערך המקסימלי על ציר הערך.
public object MaxValue { get; set; }
ערך תכונה
הערות
סוג maxValue יכול להיות רק double או DateTime
MinValue
מייצג את הערך המינימלי על ציר הערך.
public object MinValue { get; set; }
ערך תכונה
הערות
סוג minValue יכול להיות רק double או DateTime
MinorGridLines
מייצג קווי רשת קטנים על ציר התרשים.
public Line MinorGridLines { get; }
ערך תכונה
MinorTickMark
מייצג את סוג סימן הסימון הקטן עבור הציר המוגדר.
public TickMarkType MinorTickMark { get; set; }
ערך תכונה
MinorUnit
מייצג את היחידות הקטנות עבור הציר.
public double MinorUnit { get; set; }
ערך תכונה
הערות
היחידות הקטנות חייבות להיות גדולות מאפס.
MinorUnitScale
מייצג את קנה המידה של היחידה הקטנה עבור ציר הקטגוריה.
public TimeUnit MinorUnitScale { get; set; }
ערך תכונה
דוגמאות
chart.CategoryAxis.CategoryType = CategoryType.TimeScale;
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months;
chart.CategoryAxis.MinorUnit = 2;
chart.CategoryAxis.CategoryType = CategoryType.TimeScale
chart.CategoryAxis.MinorUnitScale = TimeUnit.Months
chart.CategoryAxis.MinorUnit = 2
TickLabelPosition
מייצג את המיקום של תוויות סימון על הציר המוגדר.
public TickLabelPositionType TickLabelPosition { get; set; }
ערך תכונה
TickLabelSpacing
מייצג את מספר הקטגוריות או הסדרות בין תוויות הסימון. חל רק על צירי קטגוריה וסדרות.
public int TickLabelSpacing { get; set; }
ערך תכונה
הערות
המספר חייב להיות בין 1 ל-31999.
TickLabels
מחזיר אובייקט Aspose.Cells.Charts.Axis.TickLabels המייצג את תוויות הסימון עבור הציר המוגדר.
public TickLabels TickLabels { get; }
ערך תכונה
TickMarkSpacing
מחזיר או מגדיר את מספר הקטגוריות או הסדרות בין סימני הסימון. חל רק על צירי קטגוריה וסדרות.
public int TickMarkSpacing { get; set; }
ערך תכונה
הערות
המספר חייב להיות בין 1 ל-31999.
Title
מקבל את כותרת הציר.
public Title Title { get; }
ערך תכונה
שיטות
GetAxisTexts()
מקבל את התוויות של הציר לאחר קריאת המתודה Chart.Calculate().
public string[] GetAxisTexts()
מחזיר
string[]