Class Axis

Class Axis

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

يلخص الكائن الذي يمثل محور الرسم البياني.

public class Axis

الوراثة

objectAxis

الأعضاء الموروثة

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

قيمة الخاصية

Area

AxisBetweenCategories

يمثل ما إذا كان محور القيمة يعبر محور الفئة بين الفئات.

public bool AxisBetweenCategories { get; set; }

قيمة الخاصية

bool

ملاحظات

تطبق هذه الخاصية فقط على محاور الفئة، ولا تنطبق على الرسوم البيانية ثلاثية الأبعاد.

AxisLine

يحصل على مظهر المحور.

public Line AxisLine { get; }

قيمة الخاصية

Line

BaseUnitScale

يمثل مقياس الوحدة الأساسية لمحور الفئة.

public TimeUnit BaseUnitScale { get; set; }

قيمة الخاصية

TimeUnit

ملاحظات

تعيين هذه الخاصية يؤثر فقط عندما يتم تعيين خاصية CategoryType إلى TimeScale.

Bins

يمثل الصناديق على محور الرسم البياني (Histogram/Pareto)

public AxisBins Bins { get; }

قيمة الخاصية

AxisBins

CategoryType

يمثل نوع محور الفئة.

public CategoryType CategoryType { get; set; }

قيمة الخاصية

CategoryType

CrossAt

يمثل النقطة على محور القيمة حيث يعبر محور الفئة عنه.

public double CrossAt { get; set; }

قيمة الخاصية

double

ملاحظات

يجب أن يكون الرقم صحيحًا عندما ينطبق على محور الفئة. ويجب أن تكون القيمة بين 1 و 31999.

CrossType

يمثل Aspose.Cells.Charts.Axis.CrossType على المحور المحدد حيث يعبر المحور الآخر.

public CrossType CrossType { get; set; }

قيمة الخاصية

CrossType

CustomDisplayUnit

يحدد قيمة مخصصة لوحدة العرض.

public double CustomDisplayUnit { get; set; }

قيمة الخاصية

double

DisplayUnit

يمثل تسمية الوحدة للمحور المحدد.

public DisplayUnitType DisplayUnit { get; set; }

قيمة الخاصية

DisplayUnitType

DisplayUnitLabel

يمثل تسمية وحدة على محور في الرسم البياني المحدد. تكون تسميات الوحدات مفيدة لرسم القيم الكبيرة— على سبيل المثال، بالملايين أو المليارات.

public DisplayUnitLabel DisplayUnitLabel { get; }

قيمة الخاصية

DisplayUnitLabel

HasMultiLevelLabels

يشير إلى ما إذا كانت التسميات ستظهر كمستويات متعددة.

public bool HasMultiLevelLabels { get; set; }

قيمة الخاصية

bool

ملاحظات

صالح فقط لمحور الفئة.

IsAutoTickLabelSpacing

يشير إلى ما إذا كانت المسافة بين تسميات الت tick تلقائية.

public bool IsAutoTickLabelSpacing { get; set; }

قيمة الخاصية

bool

IsAutomaticMajorUnit

يشير إلى ما إذا كانت الوحدة الرئيسية للمحور معينة تلقائيًا.

public bool IsAutomaticMajorUnit { get; set; }

قيمة الخاصية

bool

IsAutomaticMaxValue

يشير إلى ما إذا كانت القيمة القصوى معينة تلقائيًا.

public bool IsAutomaticMaxValue { get; set; }

قيمة الخاصية

bool

IsAutomaticMinValue

يشير إلى ما إذا كانت القيمة الدنيا معينة تلقائيًا.

public bool IsAutomaticMinValue { get; set; }

قيمة الخاصية

bool

IsAutomaticMinorUnit

يشير إلى ما إذا كانت الوحدة الثانوية للمحور معينة تلقائيًا.

public bool IsAutomaticMinorUnit { get; set; }

قيمة الخاصية

bool

IsDisplayUnitLabelShown

يمثل ما إذا كانت تسمية وحدة العرض تظهر على المحور المحدد.

public bool IsDisplayUnitLabelShown { get; set; }

قيمة الخاصية

bool

ملاحظات

القيمة الافتراضية هي True.

IsLogarithmic

يمثل ما إذا كان نوع مقياس محور القيمة لوغاريتمي أم لا.

public bool IsLogarithmic { get; set; }

قيمة الخاصية

bool

IsPlotOrderReversed

يمثل ما إذا كان Microsoft Excel يرسم نقاط البيانات من الأخير إلى الأول.

public bool IsPlotOrderReversed { get; set; }

قيمة الخاصية

bool

IsVisible

يمثل ما إذا كان المحور مرئيًا.

public bool IsVisible { get; set; }

قيمة الخاصية

bool

LogBase

يمثل الأساس اللوغاريتمي. القيمة الافتراضية هي 10. تنطبق فقط على Excel2007.

public double LogBase { get; set; }

قيمة الخاصية

double

MajorGridLines

يمثل الخطوط الشبكية الرئيسية على محور الرسم البياني.

public Line MajorGridLines { get; }

قيمة الخاصية

Line

أمثلة

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

قيمة الخاصية

TickMarkType

MajorUnit

يمثل الوحدات الرئيسية للمحور.

public double MajorUnit { get; set; }

قيمة الخاصية

double

ملاحظات

يجب أن تكون الوحدات الرئيسية أكبر من الصفر.

MajorUnitScale

يمثل مقياس الوحدة الرئيسية لمحور الفئة.

public TimeUnit MajorUnitScale { get; set; }

قيمة الخاصية

TimeUnit

أمثلة

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

قيمة الخاصية

object

ملاحظات

يمكن أن يكون نوع maxValue فقط double أو DateTime

MinValue

يمثل القيمة الدنيا على محور القيمة.

public object MinValue { get; set; }

قيمة الخاصية

object

ملاحظات

يمكن أن يكون نوع minValue فقط double أو DateTime

MinorGridLines

يمثل الخطوط الشبكية الثانوية على محور الرسم البياني.

public Line MinorGridLines { get; }

قيمة الخاصية

Line

MinorTickMark

يمثل نوع علامة الت tick الثانوية للمحور المحدد.

public TickMarkType MinorTickMark { get; set; }

قيمة الخاصية

TickMarkType

MinorUnit

يمثل الوحدات الثانوية للمحور.

public double MinorUnit { get; set; }

قيمة الخاصية

double

ملاحظات

يجب أن تكون الوحدات الثانوية أكبر من الصفر.

MinorUnitScale

يمثل مقياس الوحدة الرئيسية لمحور الفئة.

public TimeUnit MinorUnitScale { get; set; }

قيمة الخاصية

TimeUnit

أمثلة

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

قيمة الخاصية

TickLabelPositionType

TickLabelSpacing

يمثل عدد الفئات أو السلاسل بين تسميات علامات الت tick. تنطبق فقط على محاور الفئة والسلسلة.

public int TickLabelSpacing { get; set; }

قيمة الخاصية

int

ملاحظات

يجب أن يكون الرقم بين 1 و 31999.

TickLabels

يعود كائن Aspose.Cells.Charts.Axis.TickLabels الذي يمثل تسميات علامات الت tick للمحور المحدد.

public TickLabels TickLabels { get; }

قيمة الخاصية

TickLabels

TickMarkSpacing

يعيد أو يحدد عدد الفئات أو السلاسل بين علامات الت tick. تنطبق فقط على محاور الفئة والسلسلة.

public int TickMarkSpacing { get; set; }

قيمة الخاصية

int

ملاحظات

يجب أن يكون الرقم بين 1 و 31999.

Title

يحصل على عنوان المحور.

public Title Title { get; }

قيمة الخاصية

Title

الطرق

GetAxisTexts()

يحصل على تسميات المحور بعد استدعاء دالة Chart.Calculate().

public string[] GetAxisTexts()

العائدات

string[]

 عربي