ControlCollection - интерфейс

Статья
08/11/2011

Представляет коллекцию управляемых элементов управления в документе Word, настроенном с помощью средств разработки Office в Visual Studio.

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

Синтаксис

'Декларация
<GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")]
public interface ControlCollection : IEnumerable

Тип ControlCollection предоставляет следующие члены.

Свойства

	Имя	Описание
	Capacity	Получает или задает число элементов управления, которое может содержать коллекция ControlCollection.
	Count	Получает число элементов управления в объекте ControlCollection.
	Item[Int32]	Возвращает элемент управления по указанному индексу.
	Item[Object]	Возвращает указанный элемент управления.
	Item[String]	Возвращает элемент управления с указанным именем.

В начало страницы

Методы

	Имя	Описание
	AddBookmark(Bookmark, String)	Добавляет в документ новый элемент управления Microsoft.Office.Tools.Word.Bookmark на место существующего указанного элемента управления Microsoft.Office.Interop.Word.Bookmark.
	AddBookmark(Range, String)	Добавляет в указанный диапазон документа новый элемент управления Bookmark.
	AddBuildingBlockGalleryContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления BuildingBlockGalleryContentControl.
	AddBuildingBlockGalleryContentControl(ContentControl, String)	Добавляет в коллекцию новый объект BuildingBlockGalleryContentControl.Новый элемент управления основан на исходном элементе управления содержимым, который уже находится в документе.
	AddBuildingBlockGalleryContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления BuildingBlockGalleryContentControl.
	AddComboBoxContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления ComboBoxContentControl.
	AddComboBoxContentControl(ContentControl, String)	Добавляет в коллекцию новый объект ComboBoxContentControl.Новый элемент управления основан на исходном элементе управления содержимым, который уже находится в документе.
	AddComboBoxContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления ComboBoxContentControl.
	AddContentControl(ContentControl, String)	Добавляет новый элемент управления ContentControl, основанный на собственном элементе управления содержимым в документе.
	AddContentControl(String, WdContentControlType)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления ContentControl указанного типа.
	AddContentControl(Range, String, WdContentControlType)	Добавляет в заданный диапазон документа новый элемент управления ContentControl указанного типа.
	AddControl(Control, Range, Single, Single, String)	Добавляет в коллекцию ControlCollection указанный элемент управления с заданным диапазоном и размером.
	AddControl(Control, Single, Single, Single, Single, String)	Добавляет в коллекцию ControlCollection указанный элемент управления с заданным местоположением и размером.
	AddDatePickerContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления DatePickerContentControl.
	AddDatePickerContentControl(ContentControl, String)	Добавляет в коллекцию новый объект DatePickerContentControl.Новый элемент управления основан на исходном элементе управления содержимым, который уже находится в документе.
	AddDatePickerContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления DatePickerContentControl.
	AddDropDownListContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления DropDownListContentControl.
	AddDropDownListContentControl(ContentControl, String)	Добавляет в коллекцию новый объект DropDownListContentControl.Новый элемент управления основан на исходном элементе управления содержимым, который уже находится в документе.
	AddDropDownListContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления DropDownListContentControl.
	AddGroupContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления GroupContentControl.
	AddGroupContentControl(ContentControl, String)	Добавляет новый элемент управления GroupContentControl, основанный на собственном элементе управления содержимым в документе.
	AddGroupContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления GroupContentControl.
	AddPictureContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления PictureContentControl.
	AddPictureContentControl(ContentControl, String)	Добавляет новый элемент управления PictureContentControl, основанный на собственном элементе управления содержимым в документе.
	AddPictureContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления PictureContentControl.
	AddPlainTextContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления PlainTextContentControl.
	AddPlainTextContentControl(ContentControl, String)	Добавляет новый элемент управления PlainTextContentControl, основанный на собственном элементе управления содержимым в документе.
	AddPlainTextContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления PlainTextContentControl.
	AddRichTextContentControl(String)	Добавляет в выделенный в настоящий момент фрагмент документа новый элемент управления RichTextContentControl.
	AddRichTextContentControl(ContentControl, String)	Добавляет новый элемент управления RichTextContentControl, основанный на собственном элементе управления содержимым в документе.
	AddRichTextContentControl(Range, String)	Добавляет в указанный диапазон документа новый элемент управления RichTextContentControl.
	Contains(Object)	Определяет, входит ли указанный элемент управления в экземпляр коллекции ControlCollection.
	Contains(String)	Определяет, входит ли элемент управления с указанным именем в экземпляр коллекции ControlCollection.
	GetEnumerator	Возвращает перечислитель, который выполняет итерацию по элементам коллекции. (Унаследовано от IEnumerable.)
	GetInlineShapeForControl	Возвращает основной объект InlineShape для указанного элемента управления.
	GetShapeForControl	Возвращает основной объект Shape для указанного элемента управления.
	IndexOf(Object)	Выполняет поиск указанного элемента управления и возвращает индекс (отсчитываемый с нуля) первого вхождения элемента управления в экземпляре коллекции ControlCollection.
	IndexOf(String)	Выполняет поиск первого вхождения элемента управления с указанным именем в экземпляре коллекции ControlCollection.
	Remove(Object)	Удаляет указанный элемент управления из экземпляра коллекции ControlCollection.
	Remove(String)	Удаляет указанный элемент управления из экземпляра коллекции ControlCollection.
	RemoveAt	Удаляет элемент управления по указанному индексу из экземпляра коллекции ControlCollection.

В начало страницы

Заметки

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

Чтобы получить объект ControlCollection в проекте уровня документа, используется свойство Controls класса ThisDocument в проекте. Для получения объекта ControlCollection в проекте уровня приложения, используйте свойство Controls ведущего элемента Document, создаваемого программными средствами во время выполнения. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.

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

Задача	Действие
Добавьте элемент управления в документ.	Используйте один из методов Addимя_элемента_управления. Например, чтобы добавить элемент управления содержимым, используйте метод AddContentControl.
Удалите элемент управления из документа.	Воспользуйтесь методом 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.