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")
ویژگیها
Area
Aspose.Cells.Charts.Axis.Area را بهدست میآورد.
public Area Area { get; }
مقدار ویژگی
AxisBetweenCategories
نمایانگر این است که آیا محور مقدار در بین دستهها قطع میشود یا خیر.
public bool AxisBetweenCategories { get; set; }
مقدار ویژگی
توضیحات
این ویژگی فقط برای محورهای دستهای کاربرد دارد و برای نمودارهای 3 بعدی کاربرد ندارد.
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[]