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

ControlCollection.AddControl - метод (Control, Double, Double, Double, Double, String)

  • Статья

Добавляет заданный Control указанного размера в заданное место ControlCollection.

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

Синтаксис

'Декларация
Function AddControl ( _
    control As Control, _
    left As Double, _
    top As Double, _
    width As Double, _
    height As Double, _
    name As String _
) As ControlSite

ControlSite AddControl(
    Control control,
    double left,
    double top,
    double width,
    double height,
    string name
)

Параметры

  • left
    Тип: System.Double
    Расстояние в пунктах между левым краем элемента управления и левым краем листа.
  • top
    Тип: System.Double
    Расстояние в пунктах между верхним краем элемента управления и верхним краем листа.
  • width
    Тип: System.Double
    Ширина элемента управления в пунктах.
  • height
    Тип: System.Double
    Высота элемента управления в пунктах.
  • name
    Тип: System.String
    Имя элемента управления.

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

Тип: Microsoft.Office.Tools.Excel.ControlSite
Объект, представляющий элемент управления, который содержит заданный элемент управления на листе.

Исключения

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

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

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

Заметки

Этот метод используется для добавления любого элемента управления в коллекцию ControlCollection во время выполнения. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Примеры

В приведенном ниже примере кода с помощью метода AddControl на лист добавляются два настраиваемых пользовательских элемента управления. Первый элемент управления добавляется в диапазон ячеек. Второй элемент управления добавляется в указанное расположение. В коде изменяется свойство Top первого настраиваемого пользовательского элемента управления, что приводит к перемещению элемента управления относительно объекта ControlSite, в котором содержится элемент управления на листе. Затем в коде присваивается значение свойству Top объекта ControlSite, возвращаемого вторым пользовательским элементом управления с целью демонстрации правильного способа задания свойства Top элемента управления.

    Private Sub ExcelRangeAddControl()

        Dim CustomUserControl As New UserControl1()
        Dim CustomUserControl2 As New UserControl2()

        Dim DynamicControl As Microsoft.Office.Tools.Excel.ListObject = Me.Controls.AddControl( _
            CustomUserControl, 0, 0, 150, 150, _
            "DynamicControl")

        Dim DynamicControl2 As Microsoft.Office.Tools.Excel. _
            ControlSite = Me.Controls.AddControl( _
            CustomUserControl2, 200, 0, 150, 150, _
            "DynamicControl2")

        CustomUserControl.BackColor = Color.Blue
        CustomUserControl2.BackColor = Color.Green

        CustomUserControl.Top = 100
        DynamicControl2.Top = 100

    End Sub


private void ExcelRangeAddControl()
{

    UserControl1 customUserControl = new UserControl1();
    UserControl2 customUserControl2 = new UserControl2();

    Microsoft.Office.Tools.Excel.ControlSite dynamicControl =
        this.Controls.AddControl(customUserControl,
        0, 0, 150, 150, "dynamicControl");

    Microsoft.Office.Tools.Excel.ControlSite dynamicControl2 =
        this.Controls.AddControl(customUserControl2, 200, 0,
        150, 150, "dynamicControl2");

    customUserControl.BackColor = Color.Blue;
    customUserControl2.BackColor = Color.Green;

    customUserControl.Top = 100;
    dynamicControl2.Top = 100;
}

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

См. также

Ссылки

ControlCollection Интерфейс

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

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