مشاركة عبر

ControlExtensions.AddCheckBox أسلوب (ControlCollection, Double, Double, Double, Double, String)

  • مقالة

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

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

بناء الجملة

'إقرار
<ExtensionAttribute> _
Public Shared Function AddCheckBox ( _
    controls As ControlCollection, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As CheckBox

public static CheckBox AddCheckBox(
    this ControlCollection controls,
    double left,
    double top,
    double width,
    double height,
    string name
)

المعلمات

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

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

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

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

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

استثناءات

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

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

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

ملاحظات

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

أمثلة

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

    Private Sub ExcelAddCheckBox()

        Dim CheckBox1 As Microsoft.Office.Tools.Excel. _
            Controls.CheckBox = Me.Controls.AddCheckBox( _
            0, 0, 78, 18, "CheckBox1")
        CheckBox1.Text = "Underline"

    End Sub


private void ExcelAddCheckBox()
{
    Microsoft.Office.Tools.Excel.Controls.CheckBox checkBox1 =
        this.Controls.AddCheckBox(0, 0, 78, 18, "checkBox1");
    checkBox1.Text = "Underline";
}

أمن NET Framework.

راجع أيضًَا

المرجع

ControlExtensions الفئة

ControlExtensions الأعضاء

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

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