ControlExtensions.AddWebBrowser أسلوب (ControlCollection, Range, String)
قم بإضافة جديد WebBrowserعنصر تحكم إلى ورقة عمل في النطاق المحدد.
مساحة الاسم: Microsoft.Office.Tools.Excel
التجميع: Microsoft.Office.Tools.Excel.v4.0.Utilities (في Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
بناء الجملة
'إقرار
<ExtensionAttribute> _
Public Shared Function AddWebBrowser ( _
controls As ControlCollection, _
range As Range, _
name As String _
) As WebBrowser
public static WebBrowser AddWebBrowser(
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.WebBrowser
WebBrowserعنصر تحكم تمت إضافته إلى ControlCollectionالمثيل.
ملاحظة على الاستخدام
في Visual Basic و#C، يمكنك استدعاء هذا الأسلوب كأسلوب مثيل على أي كائن من النوع ControlCollection. عند استخدام بناء جملة أسلوب مثيل لاستدعاء مثل هذا الأسلوب، احذف المعلمة الأولى. لمزيد من المعلومات، راجع أساليب ملحق (Visual Basic) أو أساليب ملحق (C# البرمجة الدليل).
استثناءات
| استثناء: | شرط |
|---|---|
| ArgumentNullException | وسيطة اسم أو النطاق هو nullمرجع خالٍ (لا شيء في Visual Basic)، أو وسيطة "اسم" الطول الصفرية. |
| ControlNameAlreadyExistsException | عنصر تحكم بنفس الاسم هو موجود بالفعل في ControlCollectionالمثيل. |
| InvalidRangeException | النطاق الذي تم تحديده هو غير صالح. لا يمكن استخدام نطاقات multi-مساحة. يجب أن يكون النطاق ورقة عمل نفسها ك ControlCollectionمثيل. |
ملاحظات
AddWebBrowserأسلوب تمكنك من إضافة WebBrowserالكائنات إلى النهاية ControlCollection. إلى إزالة WebBrowserالذي تم مسبقاً إضافته برمجياً، استخدم Removeالأسلوب.
عنصر تحكم تلقائياً بمغٍِير حجمها عند مغٍِير حجمها النطاق.
أمثلة
يلي تعليمات برمجية المثال يضيف على WebBrowserعنصر التحكم إلى خلايا A1 حتى من M31، وثم ينتقل إلى www.microsoft.com. إلى لاستخدام هذا المثال، قم بتشغيلها من Sheet1الفئة في مشروع المستوى مستند.
Private Sub ExcelRangeAddWebBrowser()
Dim WebBrowser1 As Microsoft.Office.Tools.Excel. _
Controls.WebBrowser = Me.Controls.AddWebBrowser( _
Me.Range("A1", "M31"), "WebBrowser1")
WebBrowser1.Navigate("https://www.microsoft.com")
End Sub
private void ExcelRangeAddWebBrowser()
{
Microsoft.Office.Tools.Excel.Controls.WebBrowser
webBrowser1 = this.Controls.AddWebBrowser(
this.Range["A1", "M31"], "webBrowser1");
webBrowser1.Navigate("https://www.microsoft.com");
}
أمن NET Framework.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.