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;
//تعيين عدد الفئات أو السلاسل بين علامات الت tick.
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
'تعيين عدد الفئات أو السلاسل بين علامات الت tick.
chart.CategoryAxis.TickLabelSpacing = 2
'حفظ ملف Excel
workbook.Save("book1.xlsx")
الخصائص
Area
يحصل على 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
يمثل الصناديق على محور الرسم البياني (Histogram/Pareto)
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
يشير إلى ما إذا كانت المسافة بين تسميات الت tick تلقائية.
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
يمثل نوع علامة الت tick الرئيسية للمحور المحدد.
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
يمثل نوع علامة الت tick الثانوية للمحور المحدد.
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
يمثل موضع تسميات علامات الت tick على المحور المحدد.
public TickLabelPositionType TickLabelPosition { get; set; }
قيمة الخاصية
TickLabelSpacing
يمثل عدد الفئات أو السلاسل بين تسميات علامات الت tick. تنطبق فقط على محاور الفئة والسلسلة.
public int TickLabelSpacing { get; set; }
قيمة الخاصية
ملاحظات
يجب أن يكون الرقم بين 1 و 31999.
TickLabels
يعود كائن Aspose.Cells.Charts.Axis.TickLabels الذي يمثل تسميات علامات الت tick للمحور المحدد.
public TickLabels TickLabels { get; }
قيمة الخاصية
TickMarkSpacing
يعيد أو يحدد عدد الفئات أو السلاسل بين علامات الت tick. تنطبق فقط على محاور الفئة والسلسلة.
public int TickMarkSpacing { get; set; }
قيمة الخاصية
ملاحظات
يجب أن يكون الرقم بين 1 و 31999.
Title
يحصل على عنوان المحور.
public Title Title { get; }
قيمة الخاصية
الطرق
GetAxisTexts()
يحصل على تسميات المحور بعد استدعاء دالة Chart.Calculate().
public string[] GetAxisTexts()
العائدات
string[]