ControlCollection - интерфейс
Представляет коллекцию управляемых элементов управления на листе Excel в решении Office.
Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)
Синтаксис
'Декларация
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
Inherits IEnumerable
[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable
Тип ControlCollection предоставляет следующие члены.
Свойства
Имя | Описание | |
---|---|---|
Count | Получает число элементов управления в объекте ControlCollection. | |
Item[Int32] | Возвращает элемент управления по указанному индексу. | |
Item[String] | Возвращает элемент управления с указанным именем. |
В начало страницы
Методы
Имя | Описание | |
---|---|---|
AddChart(Range, String) | Добавляет новый элемент управления Chart в указанный диапазон листа. | |
AddChart(Double, Double, Double, Double, String) | Добавляет в заданное место листа новый элемент управления Chart указанного размера. | |
AddControl(Control, Range, String) | Добавляет определенный Control в ControlCollection в определенном диапазоне. | |
AddControl(Control, Double, Double, Double, Double, String) | Добавляет заданный Control указанного размера в заданное место ControlCollection. | |
AddListObject(ListObject) | Добавляет объект Microsoft.Office.Tools.Excel.ListObject Visual Studio в коллекцию элементов управления, основанную на указанном собственном объекте Microsoft.Office.Interop.Excel.ListObject. | |
AddListObject(Range, String) | Добавляет в заданный диапазон листа новый элемент управления ListObject. | |
AddNamedRange | Добавляет в заданный диапазон листа новый элемент управления NamedRange. | |
Contains(Object) | Определяет, входит ли указанный элемент управления в экземпляр коллекции ControlCollection. | |
Contains(String) | Определяет, входит ли элемент управления с указанным именем в экземпляр коллекции ControlCollection. | |
GetEnumerator | Возвращает перечислитель, который выполняет итерацию по элементам коллекции. (Унаследовано от IEnumerable.) | |
IndexOf(Object) | Выполняет поиск указанного элемента управления и возвращает индекс (отсчитываемый с нуля) первого вхождения элемента управления в экземпляре коллекции ControlCollection. | |
IndexOf(String) | Выполняет поиск первого вхождения элемента управления с указанным именем в экземпляре коллекции ControlCollection. | |
Remove(Object) | Удаляет заданный элемент управления из экземпляра ControlCollection. | |
Remove(String) | Удаляет элемент управления с заданным именем из экземпляра ControlCollection. | |
RemoveAt | Удаляет элемент управления по указанному индексу из экземпляра ControlCollection. |
В начало страницы
Заметки
Используйте методы и свойства интерфейса ControlCollection для управления элементами управления на листе Excel. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.
Невозможно создать экземпляр этого интерфейса в коде, поскольку он не имеет открытых конструкторов. Чтобы получить экземпляр этого интерфейса в проекте уровня документа, используйте свойство Controls одного из классов Sheetn в проекте. Чтобы получить экземпляр этого интерфейса в проекте уровня документа, используйте свойство Controls ведущего элемента Worksheet, создаваемого программными средствами во время выполнения. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.
В приведенной ниже таблице показано, как использовать члены класса ControlCollection для выполнения общих задач, связанных с элементами управления в документах.
Задача |
Действие |
---|---|
Добавьте элемент управления в лист. |
Используйте один из методов Add<элемент_управления>. Например, чтобы добавить Microsoft.Office.Tools.Excel.ListObject, воспользуйтесь методом AddListObject. |
Удалите элемент управления из листа. |
Воспользуйтесь методом Remove. |
Определите, присутствует ли элемент управления в коллекции. |
Передайте элемент управления или его имя в качестве параметра метода Contains. |
Получите индекс элемента управления в коллекции. |
Передайте элемент управления или его имя в качестве параметра метода IndexOf. |
Получите элемент управления из коллекции. |
Передайте индекс или имя элемента управления свойству Item. |
Примечание
Данный интерфейс реализован средствами Visual Studio Tools для среды выполнения Office. Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.
Использование
В настоящей документации описывается версия данного типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены и примеры, предназначенные для данного типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.