ControlCollection.AddControl - метод (Control, Double, Double, Double, Double, String)
Добавляет заданный Control указанного размера в заданное место ControlCollection.
Пространство имен: Microsoft.Office.Tools.Excel
Сборки: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (в Microsoft.Office.Tools.Excel.v4.0.Utilities.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
)
Параметры
- control
Тип: System.Windows.Forms.Control
Элемент управления, добавляемый в экземпляр ControlCollection.
- left
Тип: System.Double
Расстояние в пунктах между левым краем элемента управления и левым краем листа.
- top
Тип: System.Double
Расстояние в пунктах между верхним краем элемента управления и верхним краем листа.
- width
Тип: System.Double
Ширина элемента управления в пунктах.
- height
Тип: System.Double
Высота элемента управления в пунктах.
- name
Тип: System.String
Имя элемента управления.
Возвращаемое значение
Тип: Microsoft.Office.Tools.Excel.ControlSite
Объект, представляющий элемент управления, который содержит заданный элемент управления на листе.
Исключения
| Исключение | Условие |
|---|---|
| ArgumentNullException | Аргумент элемента управления или имени равен nullссылка 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
- Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.