ControlCollection.AddWebBrowser Метод (Range, Single, Single, String) (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Добавляет в заданное место документа новый элемент управления WebBrowser указанного размера.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word.v9.0 (в Microsoft.Office.Tools.Word.v9.0.dll)

Синтаксис

'Декларация
Public Function AddWebBrowser ( _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As WebBrowser
'Применение
Dim instance As ControlCollection
Dim range As Range
Dim width As Single
Dim height As Single
Dim name As String
Dim returnValue As WebBrowser

returnValue = instance.AddWebBrowser(range, _
    width, height, name)

public WebBrowser AddWebBrowser(
    Range range,
    float width,
    float height,
    string name
)

Параметры

range
Тип: Microsoft.Office.Interop.Word.Range
Объект Range, предоставляющий местоположение элемента управления.

width
Тип: System.Single
Ширина элемента управления в пунктах.

height
Тип: System.Single
Высота элемента управления в пунктах.

name
Тип: System.String
Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.

Возвращаемое значение

Тип: Microsoft.Office.Tools.Word.Controls.WebBrowser
Элемент управления WebBrowser, добавленный в экземпляр класса ControlCollection.

Исключения

Исключение	Условие
ArgumentNullException	Аргумент name или range равен nullссылка null (Nothing в Visual Basic), или аргумент name имеет нулевую длину.
ControlNameAlreadyExistsException	Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection.
InvalidRangeException	Указанный диапазон не существует.

Заметки

Этот метод используется для добавления объектов WebBrowser в конец коллекции ControlCollection.

Чтобы удалить добавленный программно объект WebBrowser, воспользуйтесь методом Remove.

Примеры

В приведенном ниже примере кода в первый абзац документа добавляется элемент управления WebBrowser, после чего открывается веб-узел www.microsoft.com.

Private Sub WordRangeAddWebBrowser()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim WebBrowser1 As Microsoft.Office.Tools.Word.Controls. _
        WebBrowser = Me.Controls.AddWebBrowser( _
        Me.Paragraphs(1).Range, 450, 400, "WebBrowser1")
    WebBrowser1.Navigate("https://www.microsoft.com")

End Sub

private void WordRangeAddWebBrowser()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.WebBrowser
        webBrowser1 = this.Controls.AddWebBrowser(
        this.Paragraphs[1].Range, 450, 400, "webBrowser1");
    webBrowser1.Navigate("https://www.microsoft.com");
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.