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

مقالة
09/21/2010

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

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

بناء الجملة

'إقرار
<ExtensionAttribute> _
Public Shared Function AddDomainUpDown ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As DomainUpDown

public static DomainUpDown AddDomainUpDown(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

المعلمات

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

range
النوع: Microsoft.Office.Interop.Word.Range
الالموقع عنصر تحكم.

width
النوع: System.Single
العرض عنصر تحكم بالنقاط.

height
النوع: System.Single
الارتفاع عنصر تحكم بالنقاط.

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

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

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

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

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

استثناءات

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

ملاحظات

يمكنك هذا الأسلوب من إضافة DomainUpDownالكائنات إلى النهاية ControlCollection.

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

أمثلة

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

Private Sub WordRangeAddDomainUpDown()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim DomainUpDown1 As Microsoft.Office.Tools.Word. _
        Controls.DomainUpDown = Me.Controls.AddDomainUpDown( _
        Me.Paragraphs(1).Range, 90, 15, "DomainUpDown1")
    DomainUpDown1.BackColor = Color.Yellow
End Sub

private void WordRangeAddDomainUpDown()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.DomainUpDown
        domainUpDown1 = this.Controls.AddDomainUpDown(
        this.Paragraphs[1].Range, 90, 15, "domainUpDown1");
    domainUpDown1.BackColor = Color.Yellow;
}

أمن NET Framework.

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