Worksheet.Controls Свойство (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

Получает коллекцию элементов управления, содержащихся на рабочем листе.

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

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection
'Применение
Dim instance As Worksheet
Dim value As ControlCollection

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

Значение свойства

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

Заметки

Рабочий лист может выступать в роли родительского элемента управления для коллекции элементов управления. При добавлении нескольких элементов управления в рабочий лист каждый из элементов управления является элементом коллекции ControlCollection рабочего листа.

Можно добавлять элементы управления к ControlCollection или удалять их с помощью методов, доступных в классе ControlCollection.

Примеры

В следующем примере кода с помощью свойства Controls выполняется добавление элемента управления Button в текущий рабочий лист.

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

Private Sub AddButton()
    Dim button1 As Button = _
        Me.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

private void AddButton()
{
    Button button1 = this.Controls.AddButton(50, 50, 150, 50, "button1");
}

Эта версия предназначена для надстройки уровня приложения.

Private Sub AddButton()
    Dim vstoWorksheet As Worksheet = _
        CType(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet) _
        .GetVstoObject()
    Dim button1 As System.Windows.Forms.Button = _
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

private void AddButton()
{
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    System.Windows.Forms.Button button1 = 
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1");
}

Разрешения

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

См. также

Ссылки

Worksheet Класс

Worksheet - члены

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

Журнал изменений

Дата	Журнал	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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