Работа с средствами управления контентом

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

Укажите структурированные регионы в шаблоне. Каждый структурированный регион имеет свой уникальный ID, чтобы вы могли читать и писать в него. Примерами типов структурированных областей (или элементов управления контентом) являются комбо-поля, изображения, текстовые блоки и календари.

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

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

Составить карту содержимого управления контентом с данными в настраиваемой части XML. Например, если в ячейки таблицы цен на акции вставить элементы элементов простого текстового контента, можно составить карту элементов управления контентом в ячейках таблицы с узлами в XML-файле, которые содержат текущие цены на акции. При изменении цен надстройка может программным образом обновить присоединенный XML-файл, привязанный к каждому обычному контролю текстового контента, и новые обновленные цены автоматически отображаются в таблице.

Самый простой способ создания управления контентом — это пользовательский интерфейс (хотя вы также можете создавать его программным образом). Чтобы создать элемент управления контентом с помощью пользовательского интерфейса (пользовательского интерфейса), выберите контент, который необходимо превратить в элемент управления контентом (например, текст или изображение), а затем выберите нужный тип управления контентом из раздела управления контентом ленты разработчика. Это создает управление контентом вокруг выбранного контента.

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

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

Название Описание ContentControl Каждый объект ContentControl представляет отдельный контроль контента в документе. Используйте коллекцию ContentControls для доступа к отдельным объектам ContentControl . ContentControls Используйте свойства ContentControls объектов Document, Range и Selection для доступа к коллекции элементов управления контентом. Вы также можете использовать метод SelectContentControlsByTitle и метод SelectContentControlsByTag объекта Document для доступа к коллекции ContentControls, которая включает определенные элементы управления контентом, которые имеют одно и то же название или значение тегов. ContentControlListEntry Если элемент управления контентом представляет собой выпадаемую или комбо-коробку, объект ContentControlListEntry представляет отдельные элементы в списке. ContentControlListEntries Используйте свойство DropdownListEntries объекта ContentControl , чтобы получить доступ ко всем пунктам в отдельном выпадаемом списке или в поле комбо.

Каждый из этих объектов или коллекций имеет методы и свойства, которые позволяют работать с управлением контентом как по отдельности, так и в качестве коллекции. Поскольку существуют различные типы элементов управления контентом (см. следующий раздел "Типы элементов управления контентом"), объект ContentControl имеет элементы, которые могут не применяться к различным типам элементов управления контентом. В следующей таблице показаны свойства и методы объекта ContentControl , применимые только к определенным типам элементов управления контентом.

Полный список всех свойств и методов объекта ContentControl см. в материалах Content Controls.

Типы элементов управления контентом

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

Тип управления контентом Описание Константа WdContentControlType Почтовый ящик. wdContentControlCheckBox Календарь Выбор времени даты. wdContentControlDate Стандартный блок Позволяет пользователю выбирать из указанных блоков. wdContentControlBuildingBlockGallery раскрывающийся список; Выпадаю список. wdContentControlDropDownList Group Определяет защищенный регион документа, который пользователи не могут изменить или удалить. Элемент группового управления может содержать любые элементы документа, такие как текст, таблицы, графика и другие элементы управления контентом. wdContentControlGroup поле со списком; Комбо-поле. wdContentControlComboBox рисунок; Изображение. wdContentControlBlockPicture форматированный текст; Блок богатого текста. wdContentControlRichText обычный текст; Блок простого текста. wdContentControlText

События управления контентом

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

Имя события Описание ContentControlAfterAdd Возникает после добавления нового управления контентом в документ. Это событие выполняется независимо от того, добавляет ли пользователь управление контентом с помощью средств пользовательского интерфейса или добавляет их с помощью кода. ContentControlBeforeContentUpdate Происходит до того, как Word обновит содержимое в области управления контентом. ContentControlBeforeDelete Происходит до удаления пользователем управления контентом. Это событие выполняется независимо от того, удаляет ли пользователь управление контентом с помощью средств пользовательского интерфейса или удаляет их с помощью кода. ContentControlBeforeStoreUpdate Происходит до обновления Word содержимого управления контентом из данных в хранилище данных документа. ContentControlOnEnter Возникает при вводе пользователем данных в элемент управления контентом. ContentControlOnExit Возникает, когда пользователь выходит из управления контентом.

Работа с Кодом

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

Добавление управления контентом

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

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

Добавление заголовка в управление контентом

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

Изменение текста-задатки на управление контентом

Текст placeholder — это временный текст. Это может быть простое описание одного или двух слов (аналогично названию) или более подробное описание (например, про номерные шаги). Изменение текста-задатки является одинаковым независимо от типа управления контентом или ожидаемого содержимого управления контентом. В следующем примере в активный документ добавляется отпадной список, задайте текст заполнителям для управления, а затем заполните список именами нескольких животных.

Это лишь некоторые из способов использования объектной модели для управления средствами управления контентом в документах. Дополнительные примеры см. в разделе How To .

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