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

مقالة
09/21/2010

قم بإضافة جديد PropertyGridعنصر تحكم إلى ورقة عمل في النطاق المحدد.

مساحة الاسم: Microsoft.Office.Tools.Excel
التجميع: Microsoft.Office.Tools.Excel.v4.0.Utilities (في Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

بناء الجملة

'إقرار
<ExtensionAttribute> _
Public Shared Function AddPropertyGrid ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As PropertyGrid

public static PropertyGrid AddPropertyGrid(
    this ControlCollection controls,
    Range range,
    string name
)

المعلمات

controls
النوع: Microsoft.Office.Tools.Excel.ControlCollection
مجموعة لإضافة عنصر تحكم إلى.لا تقم بإدخال هذه معلمة نفسك.عندما تقوم باستدعاء th هو الأسلوب في المجموعة التي تم إرجاعها بواسطة Worksheet.Controlsخاصية (في مشروع المستوى تطبيق) أو WorksheetBase.Controlsخاصية (في مشروع المستوى المستندات)، رقم هو معلمة هو الذي تم توفيره بشكل تلقائي.

range
النوع: Microsoft.Office.Interop.Excel.Range
Rangeوالتي توفر للحدود عنصر تحكم.

name
النوع: System.String
اسم عنصر التحكم الذي يمكن أن تستخدم لفهرسة عنصر التحكم في ControlCollectionمثيل.

القيمة المُرجعة

النوع: Microsoft.Office.Tools.Excel.Controls.PropertyGrid

ملاحظة على الاستخدام

في Visual Basic و#C، يمكنك استدعاء هذا الأسلوب كأسلوب مثيل على أي كائن من النوع ControlCollection. عند استخدام بناء جملة أسلوب مثيل لاستدعاء مثل هذا الأسلوب، احذف المعلمة الأولى. لمزيد من المعلومات، راجع أساليب ملحق (Visual Basic) أو أساليب ملحق (C# البرمجة الدليل).

استثناءات

استثناء:	شرط
ArgumentNullException	وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية.
ControlNameAlreadyExistsException	عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل.
InvalidRangeException	النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل.

ملاحظات

AddPropertyGridأسلوب تمكنك من إضافة PropertyGridالكائنات إلى النهاية ControlCollection. لإزالة PropertyGridعنصر تحكم الذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.

عنصر تحكم تلقائياً بمغٍِير حجمها عند مغٍِير حجمها النطاق.

أمثلة

يلي تعليمات برمجية في المثال إضافة على PropertyGridعنصر التحكم إلى خلايا A1 من خلال C12 وعلى Buttonعنصر التحكم إلى خلية A14. ثم يعرض الخصائص زر في PropertyGrid. إلى لاستخدام هذا المثال، قم بتشغيلها من Sheet1الفئة في مشروع المستوى مستند.

    Private Sub ExcelRangeAddPropertyGrid()
        Dim PropertyGrid1 As Microsoft.Office.Tools.Excel. _
            Controls.PropertyGrid = Me.Controls. _
            AddPropertyGrid(Me.Range("A1", "C12"), _
            "PropertyGrid1")

        Dim Button1 As Microsoft.Office.Tools.Excel. _
            Controls.Button = Me.Controls.AddButton( _
            Me.Range("A14"), "Button1")

        Button1.Text = "OK"
        PropertyGrid1.SelectedObject = Button1

    End Sub

private void ExcelRangeAddPropertyGrid()
{
    Microsoft.Office.Tools.Excel.Controls.PropertyGrid
         propertyGrid1 = this.Controls.AddPropertyGrid(
         this.Range["A1", "C12"], "propertyGrid1");

    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(this.Range["A14", missing],
        "button1");
    button1.Text = "OK";

    propertyGrid1.SelectedObject = button1;
}

أمن NET Framework.

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