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

Статья
11/16/2008

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

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

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

Синтаксис

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

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

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

Исключения

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

Заметки

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

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

Примеры

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

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;
}

Разрешения

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