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;
//تنظیم تعداد دسته‌ها یا سری‌ها بین برچسب‌های علامت‌گذاری.
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; }

مقدار ویژگی

Area

AxisBetweenCategories

نمایانگر این است که آیا محور مقدار در بین دسته‌ها قطع می‌شود یا خیر.

public bool AxisBetweenCategories { get; set; }

مقدار ویژگی

bool

توضیحات

این ویژگی فقط برای محورهای دسته‌ای کاربرد دارد و برای نمودارهای 3 بعدی کاربرد ندارد.

AxisLine

ظاهر یک محور را به‌دست می‌آورد.

public Line AxisLine { get; }

مقدار ویژگی

Line

BaseUnitScale

نمایانگر مقیاس واحد پایه برای محور دسته‌ای است.

public TimeUnit BaseUnitScale { get; set; }

مقدار ویژگی

TimeUnit

توضیحات

تنظیم این ویژگی فقط زمانی تأثیر دارد که ویژگی CategoryType به TimeScale تنظیم شده باشد.

Bins

نمایانگر سطل‌ها در محور نمودار (هیستوگرام/پارتو)

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

نشان می‌دهد که آیا فاصله برچسب علامت‌گذاری به‌صورت خودکار است

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

نمایانگر نوع علامت‌گذاری اصلی برای محور مشخص‌شده است.

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

نمایانگر نوع علامت‌گذاری جزئی برای محور مشخص‌شده است.

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

نمایانگر موقعیت برچسب‌های علامت‌گذاری در محور مشخص‌شده است.

public TickLabelPositionType TickLabelPosition { get; set; }

مقدار ویژگی

TickLabelPositionType

TickLabelSpacing

نمایانگر تعداد دسته‌ها یا سری‌ها بین برچسب‌های علامت‌گذاری است. فقط به محورهای دسته‌ای و سری‌ها اعمال می‌شود.

public int TickLabelSpacing { get; set; }

مقدار ویژگی

int

توضیحات

عدد باید بین 1 و 31999 باشد.

TickLabels

یک شیء Aspose.Cells.Charts.Axis.TickLabels را که نمایانگر برچسب‌های علامت‌گذاری برای محور مشخص‌شده است، برمی‌گرداند.

public TickLabels TickLabels { get; }

مقدار ویژگی

TickLabels

TickMarkSpacing

تعداد دسته‌ها یا سری‌ها بین علامت‌های علامت‌گذاری را برمی‌گرداند یا تنظیم می‌کند. فقط به محورهای دسته‌ای و سری‌ها اعمال می‌شود.

public int TickMarkSpacing { get; set; }

مقدار ویژگی

int

توضیحات

عدد باید بین 1 و 31999 باشد.

Title

عنوان محور را به‌دست می‌آورد.

public Title Title { get; }

مقدار ویژگی

Title

متدها

GetAxisTexts()

برچسب‌های محور را پس از فراخوانی متد Chart.Calculate() به‌دست می‌آورد.

public string[] GetAxisTexts()

بازگشت

string[]

 فارسی