ControlCollection.AddChart أسلوب (Range, String)

مقالة
09/21/2010

قم بإضافة جديد 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.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.