ContentControl Интерфейс

Определение

Пространство имен:

Microsoft.Office.Interop.Word

Сборка:

Microsoft.Office.Interop.Word.dll

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

public interface class ContentControl

[System.Runtime.InteropServices.Guid("EE95AFE3-3026-4172-B078-0E79DAB5CC3D")]
public interface ContentControl

type ContentControl = interface

Public Interface ContentControl

Атрибуты

GuidAttribute

Комментарии

Add(WdContentControlType, Object) Используйте метод коллекции для ContentControls создания элемента управления содержимым. Type Используйте параметр метода Add, чтобы указать тип создаваемого элемента управления содержимым.

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

Используйте метод , SetPlaceholderText(BuildingBlock, Range, String) чтобы изменить замещающий текст со строки по умолчанию на более подходящий для элемента управления. Используйте свойство , Title чтобы указать текст заголовка элемента управления. Он отображается над элементом управления, когда курсор находится внутри элемента управления или указатель мыши расположен над элементом управления.

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

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

	BuildingBlockCategory Свойство	Элементы управления содержимым коллекции BuildingBlock (wdContentControlBuildingBlockGallery)
	BuildingBlockType Свойство	Элементы управления содержимым коллекции BuildingBlock (wdContentControlBuildingBlockGallery)
	DateDisplayFormat Свойство	Элементы управления содержимым даты (wdContentControlDate)
	DateDisplayLocale Свойство	Элементы управления содержимым даты (wdContentControlDate)
	DateStorageFormat Свойство	Элементы управления содержимым даты (wdContentControlDate)
	DropdownListEntries Свойство	Элементы управления содержимым со списком и раскрывающимся списком (wdContentControlComboBox и wdContentControlDropdownList)
	MultiLine Свойство	Элементы управления содержимым в виде обычного текста (wdContentControlText)
	Ungroup() Метод	Элементы управления содержимым группы (wdContentControlGroup)

Свойства

AllowInsertDeleteSection	Возвращает или задает, могут ли пользователи добавлять или удалять разделы из указанного элемента управления содержимым повторяющегося раздела с помощью пользовательского интерфейса.
Appearance	Возвращает или задает внешний вид элемента управления содержимым. Чтение и запись WdContentControlAppearance
Application	_Application Возвращает объект , представляющий приложение Microsoft Word.
BuildingBlockCategory	Возвращает или задает категорию для элемента управления содержимым стандартного блока. Для чтения и записи.
BuildingBlockType	Возвращает или задает тип стандартного блока для элемента управления содержимым стандартного блока. Для чтения и записи.
Checked	Возвращает или задает текущее состояние (флажок установлен или снят) для поля проверка.
Color	Возвращает или задает цвет элемента управления содержимым. Чтение и запись WdColor.
Creator	Возвращает 32-разрядное целое число, указывающее приложение, в котором была создана надстройка. Только для чтения.
DateCalendarType	Возвращает или задает тип календаря для элемента управления содержимым календаря. Для чтения и записи.
DateDisplayFormat	Возвращает или задает формат, в котором отображаются даты. Для чтения и записи.
DateDisplayLocale	Возвращает языковой формат даты, отображаемой в элементе управления содержимым даты. Для чтения и записи.
DateStorageFormat	Возвращает или задает формат для хранения и получения дат, когда элемент управления содержимым даты привязан к хранилищу XML-данных активного документа. Для чтения и записи.
DefaultTextStyle	Возвращает или задает имя стиля символа, используемого для форматирования текста в элементе управления текстовым содержимым. Для чтения и записи.
DropdownListEntries	Возвращает элементы в элементе управления содержимым раскрывающегося списка или в элементе управления содержимым со списком. Только для чтения.
ID	Возвращает идентификацию элемента управления содержимым. Только для чтения.
Level	Возвращает уровень элемента управления содержимым— независимо от того, окружает ли элемент управления содержимым текст, абзацы, ячейки таблицы или строки таблицы; или, если он является встроенным. Только для WdContentControlLevelчтения .
LockContentControl	Возвращает или задает логическое значение, указывающее, может ли пользователь удалить элемент управления содержимым из активного документа. Для чтения и записи.
LockContents	Возвращает или задает логическое значение, указывающее, может ли пользователь изменять содержимое элемента управления содержимым. Для чтения и записи.
MultiLine	Возвращает логическое значение, указывающее, допускает ли элемент управления текстовым содержимым несколько строк текста. Для чтения и записи.
Parent	Возвращает объект , представляющий родительский объект указанного ContentControl объекта.
ParentContentControl	Возвращает родительский элемент управления содержимым для элемента управления содержимым, вложенного в элемент управления форматированного текста или элемента управления group. Только для чтения.
PlaceholderText	BuildingBlock Возвращает объект , представляющий замещающий текст для элемента управления содержимым. Только для чтения.
Range	Возвращает объект Range , представляющий содержимое элемента управления содержимым в активном документе. Только для чтения.
RepeatingSectionItems	Возвращает коллекцию повторяющихся элементов раздела в указанном элементе управления содержимым повторяющегося раздела. Только для чтения.
RepeatingSectionItemTitle	Возвращает или задает имя повторяющихся элементов раздела, используемых в контекстном меню, связанном с указанным элементом управления содержимым повторяющегося раздела. Для чтения и записи.
ShowingPlaceholderText	Возвращает логическое значение, указывающее, отображается ли замещающий текст для элемента управления содержимым. Только для чтения.
Tag	Возвращает или задает значение для идентификации элемента управления содержимым. Для чтения и записи.
Temporary	Возвращает или задает логическое значение, указывающее, следует ли удалять элемент управления содержимым из активного документа, когда пользователь изменяет содержимое элемента управления. Для чтения и записи.
Title	Возвращает или задает заголовок элемента управления содержимым. Для чтения и записи.
Type	Возвращает или задает тип для элемента управления содержимым. Для чтения и записи.
XMLMapping	Возвращает сопоставление элемента управления содержимым с XML-данными в хранилище данных документа. Только для чтения.

Методы

Copy()	Копирует элемент управления содержимым из активного документа в буфер обмена.
Cut()	Удаляет элемент управления содержимым из активного документа и перемещает его в буфер обмена.
Delete(Boolean)	Удаляет указанный элемент управления содержимым и содержимое элемента управления содержимым.
SetCheckedSymbol(Int32, String)	Задает символ, используемый для представления контрольного состояния элемента управления содержимым проверка box.
SetPlaceholderText(BuildingBlock, Range, String)	Задает текст-заполнитель, который отображается в элементе управления содержимым до тех пор, пока пользователь не введет свой собственный текст.
SetUncheckedSymbol(Int32, String)	Задает символ, используемый для представления незаверяемого состояния элемента управления содержимым проверка box.
Ungroup()	Удаляет элемент управления содержимым группы из документа, чтобы его дочерние элементы управления содержимым больше не вложены и могли свободно редактироваться.