ChartShape

ChartShape class

يمثل شكل المخطط. تتحكم خصائص وأساليب كائن ChartObject في مظهر وحجم المخطط المضمن في ورقة العمل.

public class ChartShape : Shape

الخصائص

اسموصف
ActiveXControl { get; }الحصول على عنصر تحكم ActiveX .
ActualLowerRightRow { get; }احصل على الصف السفلي الفعلي .
AlternativeText { get; set; }إرجاع أو تعيين السلسلة النصية الوصفية (البديلة) لملفShape الكائن .
AnchorType { get; set; }الحصول على العنصر النائب للشكل وتعيينه.
AutoShapeType { get; set; }الحصول على نوع الشكل التلقائي وتعيينه.
Bottom { get; set; }يمثل عرض الإزاحة الرأسية للشكل من صف الزاوية السفلية السفلية ، بوحدة البكسل .
Chart { get; }إرجاع كائن مخطط يمثل المخطط المضمن في الكائن.
ControlData { get; }يحصل على بيانات التحكم .
CreateId { get; set; }الحصول على وتعيين إنشاء معرف لهذا الشكل .
Fill { get; }إرجاع أFillFormat الكائن الذي يحتوي على خصائص تنسيق التعبئة للشكل المحدد.
Font { get; set; }يمثل خط الشكل.
FormatPicture { get; }الحصول على خيارات تنسيق الصورة وتعيينها.
Geometry { get; }الحصول على الشكل الهندسي
Glow { get; }يمثل أ كائن يحدد تأثير التوهج لعنصر الرسم البياني أو الشكل.
Group { get; }الحصول على شكل المجموعة الذي يحتوي على هذا الشكل.
HasLine { get; set; }الحصول على وتعيين حد الخط للشكل مرئي .
Height { get; set; }يمثل ارتفاع الشكل بوحدة البكسل.
HeightCM { get; set; }يمثل ارتفاع الشكل بوحدة السنتيمتر.
HeightInch { get; set; }يمثل ارتفاع الشكل بوحدة البوصة.
HeightInShape { get; set; }يمثل الإزاحة الرأسية للشكل من الحد العلوي للشكل الأصلي ، بوحدة 1/4000 من ارتفاع الشكل الأصل ..
HeightPt { get; set; }يمثل ارتفاع الشكل بوحدة النقاط.
HeightScale { get; set; }الحصول على مقياس الارتفاع وتعيينه ، بوحدة النسبة المئوية لارتفاع الصورة الأصلية . إذا لم يكن الشكل صورة ، فإن خاصية HeightScale ترجع فقط 100 ؛
HtmlText { get; set; }الحصول على وتعيين سلسلة html التي تحتوي على بيانات وبعض التنسيقات في مربع النص هذا.
Hyperlink { get; }الحصول على الارتباط التشعبي للشكل .
Id { get; }الحصول على معرف هذا الشكل.
InputRange { get; set; }الحصول على نطاق ورقة العمل المستخدم لملء مربع التحرير والسرد المحدد أو تعيينه.
IsEquation { get; }يشير إلى ما إذا كان الشكل يحتوي على معادلة فقط.
IsFilled { get; set; }يشير إلى ما إذا كان تنسيق التعبئة مرئيًا .
IsFlippedHorizontally { get; set; }الحصول على وضبط ما إذا كان الشكل مقلوبًا أفقيًا .
IsFlippedVertically { get; set; }الحصول على وتحديد ما إذا كان الشكل مقلوبًا عموديًا .
IsGroup { get; }يشير إلى ما إذا كان الشكل مجموعة .
IsHidden { get; set; }يشير إلى ما إذا كان الكائن مرئيًا .
IsInGroup { get; }يشير إلى ما إذا كان الشكل مجمّعًا .
IsLockAspectRatio { get; set; }صحيح يعني عدم السماح بإجراء تغييرات في نسبة العرض إلى الارتفاع.
IsLocked { get; set; }صواب إذا كان الكائن مؤمنًا ، خطأ إذا كان يمكن تعديل الكائن عندما تكون الورقة محمية.
IsPrintable { get; set; }صحيح إذا كان الكائن قابل للطباعة
IsRichText { get; }ما إذا كان النص نصًا منسقًا أم لا.
IsSmartArt { get; }يشير إلى ما إذا كان الشكل فنًا ذكيًا .
IsTextWrapped { get; set; }الحصول على وتعيين نوع التفاف النص للشكل الذي يحتوي على نص.
IsWordArt { get; }يشير إلى ما إذا كان هذا الشكل عبارة عن فن كلمة .
Left { get; set; }يمثل الإزاحة الأفقية للشكل من العمود الأيسر ، بوحدة البكسل .
LeftCM { get; set; }يمثل الإزاحة الأفقية للشكل من العمود الأيسر ، بوحدة سنتيمترات.
LeftInch { get; set; }يمثل الإزاحة الأفقية للشكل من العمود الأيسر ، بوحدة بوصة .
LeftInShape { get; set; }يمثل الإزاحة الأفقية للشكل من الحد الأيسر للشكل الأصلي ، بوحدة 1/4000 من عرض الشكل الأصل .
LeftToCorner { get; set; }الحصول على الإزاحة الأفقية للشكل من الحد الأيسر لورقة العمل وتعيينها.
Line { get; }يحصل على نمط الخط
LinkedCell { get; set; }الحصول على أو تعيين نطاق ورقة العمل المرتبط بقيمة عنصر التحكم.
LowerDeltaX { get; set; }الحصول على أو تعيين الإزاحة الأفقية للشكل من عمود الركن الأيمن السفلي.
LowerDeltaY { get; set; }الحصول على أو تعيين الإزاحة الرأسية للشكل من صف الركن الأيمن السفلي.
LowerRightColumn { get; set; }يمثل فهرس العمود السفلي الأيمن.
LowerRightRow { get; set; }يمثل فهرس صف الركن الأيمن السفلي.
MacroName { get; set; }الحصول على اسم الماكرو وتعيينه.
MsoDrawingType { get; }يحصل على نوع الرسم mso .
Name { get; set; }الحصول على اسم الشكل وتعيينه.
Paths { get; }الحصول على مسارات الشكل الهندسي المخصص.
Placement { get; set; }يمثل الطريقة التي يتم بها إرفاق الكائن الرسومي بالخلايا الموجودة أسفله . تتحكم الخاصية في وضع كائن ما في ورقة العمل.
Reflection { get; }يمثل أكائن يحدد تأثير الانعكاس لعنصر الرسم البياني أو الشكل.
RelativeToOriginalPictureSize { get; set; }يشير إلى ما إذا كان الشكل متناسبًا مع حجم الصورة الأصلي.
Right { get; set; }يمثل عرض الإزاحة الأفقية للشكل من عمود الركن الأيمن السفلي ، بوحدة البكسل .
RotationAngle { get; set; }الحصول على دوران الشكل وتعيينه.
ShadowEffect { get; }يمثل أ كائن يحدد تأثير الظل لعنصر المخطط أو شكله.
SoftEdges { get; set; }الحصول على نصف قطر التمويه وتعيينه ليتم تطبيقه على الحواف ، بوحدة النقاط .
Spid { get; }تحدد سلسلة اختيارية يمكن لتطبيق ما استخدامها لتعريف الشكل المعين.
Spt { get; }تحديد رقم اختياري يمكن لأحد التطبيقات استخدامه لإقران الشكل المحدد بنوع شكل محدد.
Text { get; set; }يمثل السلسلة الموجودة في كائن مربع النص هذا.
TextBody { get; }الحصول على إعداد نص الشكل وتعيينه.
TextDirection { get; set; }Gets / تعيين اتجاه تدفق النص لهذا الكائن.
TextEffect { get; }إرجاع كائن TextEffectFormat يحتوي على خصائص تنسيق تأثير النص للشكل المحدد. ينطبق على كائنات الشكل التي تمثل WordArt.
TextHorizontalAlignment { get; set; }الحصول على نوع المحاذاة الأفقية للنص للشكل وتعيينه.
TextHorizontalOverflow { get; set; }الحصول على وتعيين نوع تجاوز النص الأفقي للشكل الذي يحتوي على نص.
TextOptions { get; set; }يمثل خيارات النص للشكل.
TextOrientationType { get; set; }الحصول على نوع اتجاه النص للشكل وتعيينه.
TextShapeType { get; set; }الحصول على نوع شكل النص المحدد مسبقًا وتعيينه.
TextVerticalAlignment { get; set; }الحصول على نوع المحاذاة الرأسية للنص للشكل وتعيينه.
TextVerticalOverflow { get; set; }الحصول على وتعيين نوع تجاوز النص الرأسي للشكل الذي يحتوي على نص.
ThreeDFormat { get; }الحصول على تنسيق ثلاثي الأبعاد للشكل وتعيينه.
Title { get; set; }يحدد العنوان (التسمية التوضيحية) لكائن الشكل الحالي.
Top { get; set; }يمثل الإزاحة الرأسية للشكل من صفه العلوي ، بوحدة البكسل .
TopCM { get; set; }يمثل الإزاحة الرأسية للشكل من صفه العلوي بوحدة سنتيمترات .
TopInch { get; set; }يمثل الإزاحة الرأسية للشكل من صفه العلوي بوحدة بوصة .
TopInShape { get; set; }يمثل الإزاحة الرأسية للشكل من الحد العلوي للشكل الأصلي ، بوحدة 1/4000 من ارتفاع الشكل الأصل .
TopToCorner { get; set; }الحصول على الإزاحة الرأسية للشكل من الحد العلوي لورقة العمل وتعيينها ، بوحدة البكسل .
Type { get; }الحصول على نوع الشكل التلقائي.
UpperDeltaX { get; set; }الحصول على أو تعيين الإزاحة الأفقية للشكل من عمود الزاوية اليسرى العليا.
UpperDeltaY { get; set; }الحصول على أو تعيين الإزاحة الرأسية للشكل من صف الزاوية اليسرى العليا.
UpperLeftColumn { get; set; }يمثل فهرس عمود الزاوية اليسرى العليا.
UpperLeftRow { get; set; }يمثل فهرس صف الزاوية اليسرى العليا.
Width { get; set; }يمثل عرض الشكل بوحدة البكسل.
WidthCM { get; set; }يمثل عرض الشكل بوحدة سم.
WidthInch { get; set; }يمثل عرض الشكل بوحدة البوصة.
WidthInShape { get; set; }يمثل عرض الشكل بوحدة 1/4000 من الشكل الأصل.
WidthPt { get; set; }يمثل عرض الشكل بوحدة النقطة.
WidthScale { get; set; }الحصول على مقياس العرض وتعيينه ، بوحدة نسبة مئوية من عرض الصورة الأصلية. إذا لم يكن الشكل صورة ، فإن خاصية WidthScale ترجع فقط 100 ؛
Worksheet { get; }يحصل على ملفWorksheet الكائن الذي يحتوي على هذا الشكل.
X { get; set; }الحصول على الإزاحة الأفقية للشكل من الحد الأيسر لورقة العمل وتعيينها ، بوحدة البكسل.
Y { get; set; }الحصول على الإزاحة الرأسية للشكل من الحد العلوي لورقة العمل وتعيينها ، بوحدة البكسل .
ZOrderPosition { get; set; }إرجاع موضع الشكل بالترتيب z.

طُرق

اسموصف
AddHyperlink(string)إضافة ارتباط تشعبي للشكل .
AlignTopRightCorner(int, int)لنقل الصورة إلى الزاوية العلوية اليمنى .
CalculateTextSize()إعادة حساب منطقة النص
Characters(int, int)إرجاع كائن أحرف يمثل نطاقًا من الأحرف داخل النص.
FormatCharacters(int, int, Font, StyleFlag)تنسيق بعض الأحرف باستخدام إعداد الخط.
GetCharacters()إرجاع كافة كائنات الأحرف التي تمثل نطاقًا من الأحرف داخل النص .
GetConnectionPoints()احصل على نقاط الاتصال
GetInputRange(bool, bool)يحصل على النطاق المستخدم لملء عنصر التحكم.
GetLinkedCell(bool, bool)يحصل على النطاق المرتبط بقيمة عنصر التحكم.
GetLockedProperty(ShapeLockType)يحصل على قيمة الممتلكات المقفلة.
virtual GetResultOfSmartArt()تحويل الفن الذكي إلى أشكال مجمعة.
virtual IsSameSetting(object)إرجاع ما إذا كان الشكل متماثلاً.
MoveToRange(int, int, int, int)لنقل الشكل إلى نطاق محدد .
RemoveActiveXControl()إزالة عنصر تحكم activeX .
RemoveHyperlink()قم بإزالة الارتباط التشعبي للشكل .
SetInputRange(string, bool, bool)يحدد النطاق المستخدم لملء عنصر التحكم.
SetLinkedCell(string, bool, bool)يحدد النطاق المرتبط بقيمة عنصر التحكم.
SetLockedProperty(ShapeLockType, bool)تعيين الخاصية المقفلة .
ToFrontOrBack(int)لإحضار الشكل إلى الأمام أو إرسال الشكل إلى الخلف .
ToImage(ImageOrPrintOptions)إرجاع كائن الصورة النقطية للشكل .
ToImage(Stream, ImageOrPrintOptions)يحفظ الشكل لتيار .
ToImage(Stream, ImageType)لإنشاء صورة الشكل وحفظها في دفق بالتنسيق المحدد.
ToImage(string, ImageOrPrintOptions)يحفظ الشكل في ملف.
UpdateSelectedValue()قم بتحديث القيمة المحددة بقيمة الخلية المرتبطة.

أمثلة


[C#]

// إنشاء كائن مصنف
Workbook workbook = new Workbook();

// الحصول على مرجع ورقة العمل الأولى
Worksheet worksheet = workbook.Worksheets[0];

// إضافة قيمة عينة إلى الخلية "A1"
worksheet.Cells["A1"].PutValue(50);

// إضافة قيمة عينة إلى الخلية "A2"
worksheet.Cells["A2"].PutValue(100);

// إضافة قيمة عينة إلى الخلية "A3"
worksheet.Cells["A3"].PutValue(150);

// إضافة قيمة عينة إلى الخلية "B1"
worksheet.Cells["B1"].PutValue(60);

// إضافة قيمة عينة إلى الخلية "B2"
worksheet.Cells["B2"].PutValue(32);

// إضافة قيمة عينة إلى الخلية "B3"
worksheet.Cells["B3"].PutValue(50);

// إضافة مخطط إلى ورقة العمل
int chartIndex = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10);

// الوصول إلى مثيل المخطط المضاف حديثًا
Chart chart = worksheet.Charts[chartIndex];

// إضافة NSeries (مصدر بيانات المخطط) إلى المخطط الذي يتراوح من خلية "A1" إلى "B3"
chart.NSeries.Add("A1:B3", true);

// إظهار تسميات البيانات 
chart.NSeries[0].DataLabels.ShowValue = true;

// الحصول على شكل المخطط
ChartShape chartShape = chart.ChartObject;

// تعيين العمود الأيمن السفلي
chartShape.LowerRightColumn = 10;

// تعيين LowerDeltaX
chartShape.LowerDeltaX = 1024;

// حفظ ملف Excel
workbook.Save("book1.xls");

[VB.NET]

'إنشاء كائن مصنف
Dim workbook As Workbook = New Workbook()

'الحصول على مرجع ورقة العمل الأولى
Dim worksheet As Worksheet = workbook.Worksheets(0)

'Adding a sample value to "A1" cell
worksheet.Cells("A1").PutValue(50)

'Adding a sample value to "A2" cell
worksheet.Cells("A2").PutValue(100)

'Adding a sample value to "A3" cell
worksheet.Cells("A3").PutValue(150)

'Adding a sample value to "B1" cell
worksheet.Cells("B1").PutValue(60)

'Adding a sample value to "B2" cell
worksheet.Cells("B2").PutValue(32)

'Adding a sample value to "B3" cell
worksheet.Cells("B3").PutValue(50)

'إضافة مخطط إلى ورقة العمل
Dim chartIndex As Integer = worksheet.Charts.Add(ChartType.PieExploded, 5, 0, 25, 10)

'الوصول إلى مثيل المخطط المضاف حديثًا
Dim chart As Chart = worksheet.Charts(chartIndex)

'Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B3"
chart.NSeries.Add("A1:B3", True)

'إظهار تسميات البيانات 
chart.NSeries(0).DataLabels.ShowValue = True

'الحصول على شكل المخطط
Dim chartShape As ChartShape = chart.ChartObject

'تعيين العمود الأيمن السفلي
chartShape.LowerRightColumn = 10

'قم بتعيين LowerDeltaX
chartShape.LowerDeltaX = 1024

'حفظ ملف Excel
workbook.Save("book1.xls")

أنظر أيضا