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

Статья
11/16/2008

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

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

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

Синтаксис

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

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

public PictureBox AddPictureBox(
    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.PictureBox
Элемент управления PictureBox, добавленный в экземпляр класса ControlCollection.

Исключения

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

Заметки

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

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

Примеры

В приведенном ниже примере кода в первый абзац документа добавляется элемент управления PictureBox, после чего в элемент управления добавляется изображение. В данном примере предполагается, что в корневом каталоге диска C существует файл с именем Image.jpg.

Private Sub WordRangeAddPictureBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim PictureBox1 As Microsoft.Office.Tools.Word. _
        Controls.PictureBox = Me.Controls.AddPictureBox( _
        Me.Paragraphs(1).Range, 150, 150, "PictureBox1")
    PictureBox1.Image = System.Drawing.Image.FromFile( _
        "C:\Image.jpg")

End Sub

private void WordRangeAddPictureBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.PictureBox
         pictureBox1 = this.Controls.AddPictureBox(
         this.Paragraphs[1].Range, 150, 150, "pictureBox1");
    pictureBox1.Image = System.Drawing.Image.FromFile(
        "C:\\Image.jpg");
}

Разрешения

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