Объект ContentControl (Word)

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

Замечания

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

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(Type:=wdContentControlDropdownList) 
 
'List entries 
objCC.DropdownListEntries.Add "Cat" 
objCC.DropdownListEntries.Add "Dog" 
objCC.DropdownListEntries.Add "Horse" 
objCC.DropdownListEntries.Add "Monkey" 
objCC.DropdownListEntries.Add "Snake" 
objCC.DropdownListEntries.Add "Other"

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

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

Dim objCC As ContentControl 
 
Set objCC = ActiveDocument.ContentControls.Add(wdContentControlDate) 
 
objCC.Range.Text = "January 1, 2007" 
objCC.Type = wdContentControlText

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

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

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

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

См. также

Справочник по объектной модели Word

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.