Поделиться через


ControlExtensions.AddListBox - метод (ControlCollection, Single, Single, Single, Single, String)

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

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

Синтаксис

'Декларация
<ExtensionAttribute> _
Public Shared Function AddListBox ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As ListBox
public static ListBox AddListBox(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

Параметры

  • controls
    Тип: Microsoft.Office.Tools.Word.ControlCollection
    Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Document.Controls (в проекте уровня приложения) или свойством DocumentBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
  • left
    Тип: System.Single
    Расстояние в пунктах между левым краем элемента управления и левым краем документа.
  • top
    Тип: System.Single
    Расстояние в пунктах между верхним краем элемента управления и верхним краем документа.
  • width
    Тип: System.Single
    Ширина элемента управления в пунктах.
  • height
    Тип: System.Single
    Высота элемента управления в пунктах.
  • name
    Тип: System.String
    Имя, которое можно использовать для индексации элемента управления в экземпляре класса ControlCollection.

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

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

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа ControlCollection. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

Исключения

Исключение Условие
ArgumentNullException

Аргумент name равен nullпустая ссылка (Nothing в Visual Basic) или имеет нулевую длину.

ControlNameAlreadyExistsException

Элемент управления с таким именем уже имеется в данном экземпляре класса ControlCollection.

Заметки

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

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

Примеры

В приведенном ниже примере кода в начало документа добавляется элемент управления ListBox, после чего в список добавляются два элемента и выбирается первый из них. Чтобы использовать этот пример, запустите его из класса ThisDocument в проекте уровня документа.

Private Sub WordAddListBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim ListBox1 As Microsoft.Office.Tools.Word.Controls. _
        ListBox = Me.Controls.AddListBox(0, 0, 90, 71.25F, _
        "ListBox1")
    ListBox1.Items.Add("First Item")
    ListBox1.Items.Add("Second Item")
    ListBox1.SelectedIndex = 0
End Sub 
private void WordAddListBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.ListBox
         listBox1 = this.Controls.AddListBox(
         0, 0, 90, 71.25F, "lisBox1");
    listBox1.Items.Add("First Item");
    listBox1.Items.Add("Second Item");
    listBox1.SelectedIndex = 0;
}

Безопасность платформы .NET Framework

См. также

Ссылки

ControlExtensions Класс

AddListBox - перегрузка

Microsoft.Office.Tools.Word - пространство имен