Chart

Chart class

لتغليف الكائن الذي يمثل مخطط Excel واحدًا.

public class Chart

الخصائص

اسموصف
AutoScaling { get; set; }صحيح إذا قام Microsoft Excel بقياس مخطط ثلاثي الأبعاد بحيث يكون أقرب في الحجم إلى المخطط ثنائي الأبعاد المكافئ. يجب أن تكون الخاصية RightAngleAxes صحيحة.
BackWall { get; }إرجاع أWalls يمثل الجدار الخلفي لمخطط ثلاثي الأبعاد .
CategoryAxis { get; }الحصول على المحور X في الرسم البياني .
ChartArea { get; }الحصول على منطقة المخطط في ورقة العمل.
ChartDataTable { get; }يمثل جدول بيانات الرسم البياني .
ChartObject { get; }يمثل الرسم البياني الشكل ؛
DepthPercent { get; set; }يمثل عمق مخطط ثلاثي الأبعاد كنسبة مئوية من عرض المخطط (بين 20 و 2000 بالمائة).
DisplayNaAsBlank { get; set; }يشير إلى ما إذا كان يتم عرض # N / A كقيمة فارغة.
Elevation { get; set; }يمثل ارتفاع عرض الرسم البياني ثلاثي الأبعاد بالدرجات.
FirstSliceAngle { get; set; }الحصول على أو تحديد زاوية المخطط الدائري الأول أو شريحة المخطط الدائري المجوف بالدرجات (باتجاه عقارب الساعة من الوضع الرأسي). ينطبق فقط على المخططات الدائرية والدائرية ثلاثية الأبعاد والدائرية المجوفة ، من 0 إلى 360.
Floor { get; }إرجاع أFloor كائن يمثل جدران مخطط ثلاثي الأبعاد .
GapDepth { get; set; }الحصول على المسافة بين سلسلة البيانات في مخطط ثلاثي الأبعاد أو تعيينها ، كنسبة مئوية من عرض العلامة. يجب أن تكون قيمة هذه الخاصية بين 0 و 500.
GapWidth { get; set; }إرجاع أو تعيين المسافة بين مجموعات الشريط أو العمود ، كنسبة مئوية من عرض الشريط أو العمود . يجب أن تكون قيمة هذه الخاصية بين 0 و 500.
HeightPercent { get; set; }إرجاع أو تعيين ارتفاع مخطط ثلاثي الأبعاد كنسبة مئوية من عرض المخطط (بين 5 و 500 بالمائة) .
HidePivotFieldButtons { get; set; }يشير إلى ما إذا كان يتم إخفاء أزرار حقل المخطط المحوري فقط عندما يكون المخطط PivotChart.
Is3D { get; }يشير إلى ما إذا كان الرسم البياني هو مخطط ثلاثي الأبعاد .
IsRectangularCornered { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كانت منطقة الرسم البياني مستطيلة الشكل. القيمة الافتراضية هي true .
Legend { get; }الحصول على وسيلة إيضاح الرسم البياني .
Line { get; }يحصل على الخط .
Name { get; set; }الحصول على اسم المخطط وتعيينه.
NSeries { get; }يحصل على أSeriesCollection مجموعة تمثل سلسلة البيانات في الرسم البياني.
PageSetup { get; }يمثل وصف إعداد الصفحة في هذا المخطط.
Perspective { get; set; }إرجاع أو تعيين المنظور لطريقة عرض المخطط ثلاثي الأبعاد. يجب أن تكون بين 0 و 100. يتم تجاهل هذه الخاصية إذا كانت الخاصية RightAngleAxes هي True.
PivotOptions { get; }يحدد عناصر التحكم المحورية التي تظهر في المخطط
PivotSource { get; set; }المصدر هو بيانات pivotTable . إذا لم يكن PivotSource فارغًا ، فسيكون المخطط PivotChart.
Placement { get; set; }يمثل طريقة إرفاق الرسم البياني بالخلايا الموجودة أسفله.
PlotArea { get; }الحصول على منطقة الرسم البياني للمخطط والتي تتضمن تسميات تجزئة المحور.
PlotBy { get; }الحصول على وتحديد ما إذا كان الرسم بواسطة الصف أو العمود.
PlotEmptyCellsType { get; set; }الحصول على كيفية رسم الخلايا الفارغة وتعيينها.
PlotVisibleCells { get; set; }يشير إلى ما إذا كان يتم رسم الخلايا المرئية فقط.
PrintSize { get; set; }الحصول على حجم الرسم البياني المطبوع وتعيينه.
RightAngleAxes { get; set; }صحيح إذا كانت محاور الرسم البياني في زوايا قائمة. ينطبق فقط على المخططات ثلاثية الأبعاد (باستثناء المخططات الدائرية العمودية ثلاثية الأبعاد وثلاثية الأبعاد) .
RotationAngle { get; set; }يمثل استدارة عرض المخطط ثلاثي الأبعاد (دوران منطقة الرسم حول المحور z ، بالدرجات) .
SecondCategoryAxis { get; }الحصول على المحور X الثاني للرسم البياني .
SecondValueAxis { get; }الحصول على المحور ص الثاني في الرسم البياني .
SeriesAxis { get; }الحصول على محور سلسلة الرسم البياني .
Shapes { get; }إرجاع كافة أشكال الرسم في هذا المخطط.
ShowDataTable { get; set; }الحصول على أو تعيين قيمة تشير إلى ما إذا كان الرسم البياني يعرض جدول بيانات أم لا.
ShowLegend { get; set; }الحصول على قيمة أو تعيينها للإشارة إلى ما إذا كان سيتم عرض وسيلة إيضاح الرسم البياني أم لا. الافتراضي هو الصحيح.
SideWall { get; }إرجاع أWallsيمثل الجدار الجانبي لمخطط ثلاثي الأبعاد .
SizeWithWindow { get; set; }صحيح إذا قام Microsoft Excel بتغيير حجم المخطط ليلائم حجم نافذة ورقة المخطط.
Style { get; set; }الحصول على النمط المدمج وتحديده.
SubTitle { get; }الحصول على العنوان الفرعي للرسم البياني . فقط لملف تنسيق ODS .
Title { get; }الحصول على عنوان الرسم البياني .
Type { get; set; }الحصول على نوع الرسم البياني أو تحديده.
ValueAxis { get; }الحصول على المحور ص في الرسم البياني .
Walls { get; }إرجاع أWalls كائن يمثل جدران مخطط ثلاثي الأبعاد .
WallsAndGridlines2D { get; set; }صحيح إذا تم رسم خطوط الشبكة ثنائية الأبعاد على مخطط ثلاثي الأبعاد.
Worksheet { get; }الحصول على ورقة العمل التي تحتوي على هذا الرسم البياني .

طُرق

اسموصف
Calculate()حساب الموضع المخصص لمنطقة قطعة الأرض ، والمحاور إذا تم تعيين موضعها تلقائيًا.
GetActualSize()الحصول على الحجم الفعلي للرسم البياني بوحدة البكسل .
GetChartDataRange()يحصل على نطاق مصدر البيانات للمخطط.
HasAxis(AxisType, bool)إرجاع المحاور الموجودة على الرسم البياني.
IsChartDataChanged()يكتشف ما إذا كان مصدر بيانات الرسم البياني قد تغير.
Move(int, int, int, int)نقل الرسم البياني إلى مكان محدد .
RefreshPivotData()تحديث بيانات الرسم البياني المحوري من مصدر البيانات المحوري.
SetChartDataRange(string, bool)يحدد نطاق البيانات للرسم البياني .
SwitchRowColumn()مفاتيح الصف / العمود .
ToImage()يحصل على 32 بتنقطية كائن من الرسم البياني .
ToImage(ImageOrPrintOptions)يحصل على 32 بتنقطية كائن من الرسم البياني . خيارات ImageOrPrintOptions. تنسيق الصورة و ImageOrPrintOptions.TiffCompression و ImageOrPrintOptions. يتم تجاهل سمات الجودة.
ToImage(string)ينشئ صورة المخطط ويحفظها في ملف. امتداد اسم الملف يحدد تنسيق الصورة.
ToImage(Stream, ImageOrPrintOptions)لإنشاء صورة المخطط وحفظها في دفق بالتنسيق المحدد.
ToImage(Stream, ImageType)لإنشاء صورة المخطط وحفظها في دفق بالتنسيق المحدد.
ToImage(Stream, long)لإنشاء صورة المخطط وحفظها في تدفق بتنسيق Jpeg .
ToImage(string, ImageOrPrintOptions)ينشئ صورة المخطط ويحفظها في ملف. امتداد اسم الملف يحدد تنسيق الصورة.
ToImage(string, ImageType)لإنشاء صورة الرسم البياني وحفظها في ملف من نوع الصورة المحدد.
ToImage(string, long)لإنشاء صورة المخطط وحفظها في ملف بتنسيق Jpeg .
ToPdf(Stream)لإنشاء مخطط pdf وحفظه في تيار .
ToPdf(string)يحفظ الرسم البياني في ملف pdf .
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)لإنشاء مخطط pdf وحفظه في تيار .
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)يحفظ الرسم البياني في ملف pdf .

أمثلة

[C#]

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
		
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);

Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Income Analysis";

[Visual Basic]

Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
		
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)

Dim chart as Chart = sheet.Charts(chartIndex) 
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Income Analysis"

أنظر أيضا