ContentControl - интерфейс

Статья
05/19/2013

Представляет в документе элемент управления содержимым.

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

Синтаксис

'Декларация
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

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

Свойства

	Имя	Описание
	Application	Получает объект Microsoft.Office.Interop.Word.Application, представляющий текущий экземпляр Microsoft Office Word.
	BindingContext	Возвращает или задает коллекцию диспетчеров валют для IBindableComponent. (Унаследовано от IBindableComponent.)
	BuildingBlockCategory	Возвращает или задает категорию стандартных блоков, отображаемых в элементе управления ContentControl, представляющем коллекцию стандартных блоков.
	BuildingBlockType	Получает или задает тип стандартных блоков, отображаемых в элементе управления ContentControl, представляющем коллекцию стандартных блоков.
	Checked	Получает или задает значение, указывающее, установлен ли объект ContentControl, представляющий элемент управления "флажок".
	Container	Инфраструктура. (Унаследовано от ContentControlBase.)
	ContainerComponent	Инфраструктура. (Унаследовано от ContentControlBase.)
	Creator	Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления ContentControl.
	DataBindings	Возвращает коллекцию объектов привязки данных для данного IBindableComponent. (Унаследовано от IBindableComponent.)
	DateCalendarType	Получает или задает тип календаря, отображаемого в элементе управления ContentControl, представляющем управляющий элемент выбора даты.
	DateDisplayFormat	Возвращает или задает строку, указывающую формат дат, отображаемых в элементе управления ContentControl, представляющем управляющий элемент выбора даты.
	DateDisplayLocale	Получает или задает языковой формат даты, отображаемой в элементе управления ContentControl, представляющем управляющий элемент выбора даты.
	DateStorageFormat	Получает или задает формат, в котором сохраняются даты в пользовательской XML-части элементом управления ContentControl, представляющем управляющий элемент выбора даты.
	DefaultDataSourceUpdateMode	Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase. (Унаследовано от ContentControlBase.)
	DefaultTextStyle	Возвращает имя стиля знака, используемого для форматирования текста в элементе управления ContentControl.
	DropDownListEntries	Получает коллекцию элементов, отображаемых элементом управления ContentControl, представляющем раскрывающийся список или поле со списком.
	ID	Возвращает уникальное число, идентифицирующее элемент управления содержимым. (Унаследовано от ContentControlBase.)
	InnerObject	Получает базовый объект Microsoft.Office.Interop.Word.ContentControl для объекта Microsoft.Office.Tools.Word.ContentControlBase. (Унаследовано от ContentControlBase.)
	LockContentControl	Возвращает или задает значение, указывающее, можно ли удалить из документа элемент управления ContentControl.
	LockContents	Возвращает или задает значение, указывающее, можно ли изменять содержимое элемента управления ContentControl.
	MultiLine	Возвращает или задает значение, указывающее, может ли элемент управления ContentControl содержать разрывы строк.
	Parent	Возвращает родительский объект для элемента управления ContentControl.
	ParentContentControl	Получает родительский элемент управления содержимым для элемента управления ContentControl, вложенного в другой элемент управления содержимым.
	PlaceholderText	Возвращает текст, отображаемый в элементе управления ContentControl, пока текст не будет изменен в результате действий пользователя или иной операции.
	Range	Получает объект Range, представляющий содержимое элемента управления ContentControl.
	ShowingPlaceholderText	Возвращает значение, указывающее, отображается ли в настоящее время в элементе управления ContentControl замещающий текст.
	Site	Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.)
	Tag	Возвращает или задает строку, которую необходимо связать с элементом управления ContentControl.
	Temporary	Возвращает или задает значение, указывающее, будет ли элемент управления ContentControl автоматически удаляться из документа при изменении этого элемента управления.
	Title	Получает или задает заголовок ContentControl.
	Type	Получает или задает значение, указывающее тип элемента управления содержимым, представляемого элементом управления ContentControl.
	XMLMapping	Получает объект XMLMapping, представляющий привязку между элементом управления ContentControl и элементом в пользовательской XML-части.

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

Методы

	Имя	Описание
	BeginInit	Подает сигнал объекту о начале инициализации. (Унаследовано от ISupportInitialize.)
	Copy	Копирует элемент управления ContentControl из документа в буфер обмена.
	Cut	Удаляет из документа элемент управления ContentControl и заносит его в буфер обмена.
	Delete	Удаляет из документа и коллекции ControlCollection динамически созданный элемент управления содержимым. (Унаследовано от ContentControlBase.)
	Dispose	Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.)
	EndInit	Подает объекту сигнал о завершении инициализации. (Унаследовано от ISupportInitialize.)
	SetCheckedSymbol	Задает символ, который используется для представления установленного состояния объекта ContentControl, представляющего элемент управления "флажок".
	SetPlaceholderText	Выводит текст, хранящийся в объекте BuildingBlock, объекте Range или строке в качестве замещающего текста в элементе управления ContentControl.
	SetUncheckedSymbol	Задает символ используется непроверенное состояние представления ContentControl, представляющее элемент управления checkbox
	Ungroup	Удаляет из документа элемент управления групповым содержимым, содержащий элемент управления ContentControl, после чего область перестает быть защищенной.

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

События

	Имя	Описание
	Added	Происходит после добавления в документ элемента управления содержимым. (Унаследовано от ContentControlBase.)
	BindingContextChanged	Происходит при изменении значения свойства BindingContext объекта ContentControlBase. (Унаследовано от ContentControlBase.)
	ContentUpdating	Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части. (Унаследовано от ContentControlBase.)
	Deleting	Происходит непосредственно перед удалением из документа элемента управления содержимым. (Унаследовано от ContentControlBase.)
	Disposed	Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.)
	Entering	Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым. (Унаследовано от ContentControlBase.)
	Exiting	Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым. (Унаследовано от ContentControlBase.)
	StoreUpdating	Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет в пользовательской XML-части, связанной с элементом управления содержимым (то есть после того, как изменится текст в элементе управления содержимым). (Унаследовано от ContentControlBase.)
	Validated	Происходит после успешной проверки элемента управления содержимым. (Унаследовано от ContentControlBase.)
	Validating	Происходит при проверке содержимого элемента управления. (Унаследовано от ContentControlBase.)

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

Заметки

Объект ContentControl является изменяемым элементом управления, представляющим любой из восьми элементов управления, которые можно использовать в приложении Microsoft Office Word.Например, при создании объекта ContentControl, который изначально выполнял функции элемента управления обычным текстом, его можно изменить во время выполнения таким образом, чтобы он стал выполнять функции поля со списком.Другие элементы управления содержимым нельзя использовать таким образом.Например, объект RichTextContentControl может представлять только элемент управления текстом в формате RTF.Дополнительные сведения об элементах управления содержимым см. в разделе Элементы управления содержимым.

Чтобы создать элемент управления ContentControl, воспользуйтесь одним из методов AddContentControl.Элемент управления ContentControl нельзя добавить в документ во время разработки.

При создании элемента управления ContentControl необходимо указать тип создаваемого элемента управления содержимым, либо воспользоваться в качестве основы для нового элемента управления существующим элементом управления.После создания элемента управления ContentControl можно с помощью свойства Type изменить тип представляемого элемента управления содержимым.

Некоторые члены класса ContentControl выдают исключение при попытке их использования, когда элементу управления присвоен тип, не предназначенный для использования данным членом класса.Например, свойство DateCalendarType выдаст исключение при попытке его использования с элементом управления ContentControl, который не является элементом выбора даты.

Примечание
Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office.

Использование

В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.