ControlCollection.AddChart أسلوب (Range, String)
قم بإضافة جديد Chartعنصر تحكم إلى ورقة عمل في النطاق المحدد.
مساحة الاسم: Microsoft.Office.Tools.Excel
التجميع: Microsoft.Office.Tools.Excel (في Microsoft.Office.Tools.Excel.dll)
بناء الجملة
'إقرار
Function AddChart ( _
range As Range, _
name As String _
) As Chart
Chart AddChart(
Range range,
string name
)
المعلمات
- range
النوع: Microsoft.Office.Interop.Excel.Range
Rangeوالتي توفر للحدود عنصر تحكم.
- name
النوع: System.String
اسم عنصر التحكم الذي يمكن أن تستخدم لفهرسة عنصر التحكم في ControlCollectionمثيل.
القيمة المُرجعة
النوع: Microsoft.Office.Tools.Excel.Chart
Chartعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.
استثناءات
استثناء: | شرط |
---|---|
ArgumentNullException | وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية. |
ControlNameAlreadyExistsException | عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل. |
InvalidRangeException | النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل. |
ملاحظات
AddChartأسلوب تمكنك من إضافة Chartعناصر التحكم إلى النهاية ControlCollection. لإزالة Chartعنصر تحكم الذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.
أمثلة
يلي تعليمات برمجية المثال يدرج رقم 16 ل خلايا من E1 E3 والرقم 24 ل خلايا F1 خلال من المفتاح F3. بإنشاء تعليمات برمجية ثم Chartعنصر تحكم خلايا A1 إلى C8 ومسارات الخلايا E1 من خلال F3 SetSourceDataأسلوب يملأ المخطط مع بيانات.
Private Sub ExcelAddRangeChart()
Me.Range("E1", "E3").Value2 = 16
Me.Range("F1", "F3").Value2 = 24
Dim Chart1 As Microsoft.Office.Tools.Excel.Chart _
= Me.Controls.AddChart(Me.Range("A1", "C8"), _
"Chart1")
Chart1.SetSourceData(Me.Range("E1", "F5"), _
Excel.XlRowCol.xlColumns)
Chart1.ChartType = Excel.XlChartType. _
xlColumnClustered
End Sub
private void ExcelAddRangeChart()
{
this.Range["E1", "E3"].Value2 = 16;
this.Range["F1", "F3"].Value2 = 24;
Microsoft.Office.Tools.Excel.Chart chart1 =
this.Controls.AddChart(this.Range["A1", "C8"], "Chart1");
chart1.SetSourceData(this.Range["E1", "F5"], Excel.XlRowCol.xlColumns);
chart1.ChartType = Excel.XlChartType.xlColumnClustered;
}
أمن NET Framework.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.