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


ControlExtensions.AddComboBox - метод (ControlCollection, Range, String)

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

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

Синтаксис

'Декларация
<ExtensionAttribute> _
Public Shared Function AddComboBox ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As ComboBox
public static ComboBox AddComboBox(
    this ControlCollection controls,
    Range range,
    string name
)

Параметры

  • controls
    Тип: Microsoft.Office.Tools.Excel.ControlCollection
    Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Worksheet.Controls (в проекте уровня приложения) или свойством WorksheetBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.
  • name
    Тип: System.String
    Имя элемента управления, которое можно использовать для индексации элемента управления в экземпляре ControlCollection.

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

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

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

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

Исключения

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

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

ControlNameAlreadyExistsException

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

InvalidRangeException

Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.

Заметки

Метод AddComboBox используется для добавления объектов ComboBox в конец ControlCollection. Чтобы удалить добавленный программно объект ComboBox, воспользуйтесь методом Remove.

Размер элемента управления автоматически изменяется при изменении размера диапазона.

Примеры

В следующем примере кода добавляется элемент управления ComboBox в ячейках A1 до B1, добавляет два пункта в поле со списком и затем выбирает первый пункт. Чтобы использовать этот пример, запустите его из класса Sheet1 в проекте уровня документа.

    Private Sub ExcelRangeAddComboBox()

        Dim ComboBox1 As Microsoft.Office.Tools.Excel. _
            Controls.ComboBox = Me.Controls.AddComboBox( _
            Me.Range("A1", "B1"), "ComboBox1")
        ComboBox1.Items.Add("First Item")
        ComboBox1.Items.Add("Second Item")
        ComboBox1.SelectedIndex = 0

    End Sub

private void ExcelRangeAddComboBox()
{

    Microsoft.Office.Tools.Excel.Controls.ComboBox
        comboBox1 = this.Controls.AddComboBox(
        this.Range["A1", "B1"], "comboBox1");
    comboBox1.Items.Add("First Item");
    comboBox1.Items.Add("Second Item");
    comboBox1.SelectedIndex = 0;
}

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

См. также

Ссылки

ControlExtensions Класс

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

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