ControlCollection - интерфейс

Статья
08/11/2011

Представляет коллекцию управляемых элементов управления на листе 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.

См. также

Ссылки

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

Share via