مشاركة عبر


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

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

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

بناء الجملة

'إقرار
<ExtensionAttribute> _
Public Shared Function AddDomainUpDown ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As DomainUpDown
public static DomainUpDown AddDomainUpDown(
    this ControlCollection controls,
    Range range,
    string name
)

المعلمات

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

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

النوع: Microsoft.Office.Tools.Excel.Controls.DomainUpDown
DomainUpDownعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.

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

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

استثناءات

استثناء: شرط
ArgumentNullException

وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية.

ControlNameAlreadyExistsException

عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل.

InvalidRangeException

النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل.

ملاحظات

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

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

أمثلة

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

    Private Sub ExcelRangeAddDomainUpDown()

        Dim DomainUpDown1 As Microsoft.Office.Tools. _
            Excel.Controls.DomainUpDown = Me.Controls. _
            AddDomainUpDown(Me.Range("A1", "B1"), _
            "DomainUpDown1")
        DomainUpDown1.BackColor = Color.Yellow

    End Sub

private void ExcelRangeAddDomainUpDown()
{

    Microsoft.Office.Tools.Excel.Controls.DomainUpDown
        domainUpDown1 = this.Controls.AddDomainUpDown(
        this.Range["A1", "B1"], "domainUpDown1");
    domainUpDown1.BackColor = Color.Yellow;
}

أمن NET Framework.

راجع أيضًَا

المرجع

ControlExtensions الفئة

ControlExtensions الأعضاء

AddDomainUpDown التحميل الزائد

Microsoft.Office.Tools.Excel مساحة الاسم