Word

Word элементы управления: Элементы управления содержимым — Служба поддержки Майкрософт

Содержание

Элементы управления содержимым — Служба поддержки Майкрософт

Word для Microsoft 365 Word 2021 Word 2019 Word 2016 Word 2013 Word 2010 Word 2007 Еще…Меньше

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

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

Элементы управления содержимым находятся на вкладке Разработчик.

    org/ItemList»>

  1. Выберите Файл > Параметры > Настроить ленту.

  2. В списке вкладок в разделе Настройка ленты установите флажок Разработчик и нажмите кнопку ОК.

  3. Выполните одно из указанных ниже действий.

    • Чтобы добавить элемент управления, щелкните то место в документе, куда вы хотите его добавить, и выберите нужный элемент управления на вкладке Конструктор.

    • org/ListItem»>

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

  1. Нажмите кнопку Microsoft Office кнопки >параметры Word >популярные.

  2. Установите флажок

    Показывать вкладку Разработчик на ленте, а затем нажмите кнопку OК.

  3. Выполните одно из указанных ниже действий.

    • Чтобы добавить элемент управления, щелкните то место в документе, куда вы хотите его добавить, и выберите нужный элемент управления на вкладке Конструктор.

    • Чтобы задать свойства элемента управления или изменить существующий элемент, на вкладке Разработчик в группе Элементы управления

      нажмите кнопку Свойства.

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

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

  • Статья
  • Чтение занимает 6 мин

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

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

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

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

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

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

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

  • Сопоставляйте содержимое элемента управления с данными в пользовательской 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 см. в разделе Элементы управления содержимым.

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

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

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

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

События элемента управления содержимым

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

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

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

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

Добавление элемента управления содержимым

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

Sub AddDatePicker() 
 
    Dim objCC As ContentControl 
    Dim objDate As Date 
 
    Set objCC = ActiveDocument. ContentControls _ 
        .Add(wdContentControlDate) 
    objDate = Date 
    objCC.Range.Text = objDate 
     
End Sub

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

Добавление заголовка в элемент управления содержимым

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

Sub SetTitleForContentControl() 
 
    Dim objCC As ContentControl 
     
    Set objCC = ActiveDocument.ContentControls _ 
        .Add(wdContentControlText) 
         
    objCC.Title = "Please enter your name" 
     
End Sub

Изменение замещающего текста в элементе управления содержимым

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

Sub SetPlaceholderText() 
 
    Dim objCC As ContentControl 
     
    Set objCC = Selection.ContentControls _ 
        .Add(wdContentControlComboBox) 
    objCC.Title = "Favorite Animal" 
    objCC.SetPlaceholderText _ 
        Text:="Please select your favorite animal " 
     
    '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" 
 
End Sub

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

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

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

Об элементах управления содержимым — служба поддержки Майкрософт

Word для Microsoft 365 Word 2021 Word 2019 Word 2016 Word 2013 Word 2010 Word 2007 Дополнительно… Меньше

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

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

Элементы управления содержимым находятся на вкладке Разработчик .

  1. Щелкните Файл > Параметры > Настроить ленту .

  2. В списке вкладок под Настройка ленты выберите поле Разработчик и нажмите OK .

  3. Выполните одно из следующих действий:

    • org/ListItem»>

      Чтобы добавить элемент управления, щелкните в документе, куда вы хотите его добавить, а затем щелкните элемент управления, который вы хотите добавить, на Дизайн вкладка.

    • Чтобы задать свойства элемента управления или изменить существующий элемент управления, на вкладке Разработчик в группе Элементы управления щелкните Свойства .

  1. Нажмите кнопку Microsoft Office > Параметры Word > Популярные .

  2. org/ListItem»>

    Выберите Показать вкладку «Разработчик» на ленте и нажмите OK .

  3. Выполните одно из следующих действий:

    • Чтобы добавить элемент управления, щелкните в документе, куда вы хотите его добавить, а затем щелкните элемент управления, который вы хотите добавить, на Дизайн вкладка.

    • Чтобы задать свойства элемента управления или изменить существующий элемент управления, на вкладке Разработчик в группе Элементы управления щелкните Свойства .

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

элементов управления содержимым в Word | Microsoft Learn

  • Статья
  • 15 минут на чтение

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

В этом разделе содержится информация об изменениях элементов управления содержимым в Microsoft Word 2013 и сценариях документов, которые включают эти изменения.

Структурированные документы

Структурированные документы — это документы, которые определяют, где может отображаться содержимое в документе, какой тип содержимого может отображаться в документе и можно ли редактировать это содержимое.

Вот несколько распространенных сценариев для структурированного содержимого в Microsoft Word:

  • Юридической фирме необходимо создавать документы, содержащие юридические формулировки, которые пользователь не должен изменять.

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

  • Компании необходимо создавать счета-фактуры, в которых данные о клиентах включаются в счет-фактуру в предопределенных регионах.

Использование элементов управления содержимым для структурирования документа

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

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

Элементы управления содержимым в Word 2010

Следующие элементы управления содержимым доступны в Word 2010:

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

Улучшения управления содержимым в Word 2013

В Word 2013 элементы управления содержимым обеспечивают три ключевых улучшения: улучшенную визуализацию, поддержку сопоставления XML для элементов управления содержимым Rich Text и новый элемент управления содержимым для повторяющегося содержимого.

Улучшенная визуализация

Word 2013 позволяет отображать отдельный элемент управления содержимым в одном из трех возможных состояний:

  • Граничная рамка

  • Начальный/конечный теги

  • Нет

Примечание

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

Рис. 1. Диалоговое окно «Свойства элемента управления содержимым»

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

Ограничивающая рамка

По умолчанию для элементов управления содержимым в Word 2013 отображается внешний вид элементов управления содержимым, как в Word 2007 и Word 2010; то есть в качестве ограничивающей рамки. Когда элемент управления содержимым настроен на отображение в виде Bounding Box , отображение изменяется в зависимости от следующего взаимодействия с пользователем:

  • Когда элемент управления содержимым не имеет фокуса, визуализация не происходит

  • При наведении курсора элемент управления содержимым отображается в виде заштрихованного прямоугольника

Рис. 2. Элемент управления содержимым при наведении указателя мыши

  • Когда элемент управления содержимым находится в фокусе (когда пользователь выбирает элемент управления содержимым), элемент управления отображается в виде «ограничивающей рамки» (с линией вокруг содержание и отображение заголовка, если заголовок был установлен)

Рис. 3. Элемент управления содержимым с фокусом

Начальный/конечный теги

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

Рис. 4. Элемент управления содержимым настроен на отображение в виде начального/конечного тегов

Нет

Если элемент управления содержимым настроен на отображение Нет , элемент управления содержимым не отображается.

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

Помимо включения другого типа отображения элемента управления содержимым, Word 2013 также позволяет установить цвет для отдельного элемента управления содержимым. Вы устанавливаете цвет элемента управления содержимым с помощью 9Кнопка 0175 Цвет в диалоговом окне Свойства управления содержимым .

Вы также можете установить цвет элемента управления содержимым с помощью объектной модели Word 2013 (обсуждается позже в новых элементах объектной модели управления содержимым Word 2013). Рисунок 5. Диалоговое окно «Свойства элемента управления содержимым» магазин. Для этого вы устанавливаете Сопоставление XML для элемента управления содержимым. Это свойство можно задать с помощью существующего метода XMLMapping.SetMapping в объектной модели. В настраиваемой части XML пользовательский XML хранится как плоская разметка Open XML, преобразованная в строку (с использованием стандартной кодировки XML), чтобы ее можно было сохранить как текстовый узел в пользовательской части XML. Однако сопоставление по-прежнему имеет ограничение, состоящее в том, что оно может успешно сопоставляться только с конечными узлами или атрибутами.

Примечание

Элементы управления форматированным текстовым содержимым не могут содержать другие элементы управления форматированным текстовым содержимым. Если один элемент существует внутри другого (например, из-за манипулирования форматом файла, копирования и вставки и т. д.), он отсоединяется до тех пор, пока не перестанет содержаться в сопоставленном элементе управления форматированным текстом.

Дополнительные сведения о настройке сопоставления XML см. в разделе Новые члены объектной модели управления содержимым Word 2013 далее в этом разделе.

Поддержка повторяющегося содержимого

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

Вы вставляете элемент управления содержимым повторяющегося раздела вокруг целых абзацев или строк таблицы. Как только элемент управления окружает раздел, вы можете вставить копии раздела выше или ниже содержащегося раздела. Рис. 6. Контекстное меню элемента управления содержимым повторяющегося раздела команду контекстного меню, как показано на рис. 6. Повторяющееся содержимое становится отдельным разделом элемента управления, которому можно присвоить заголовок с помощью кнопки 9.0175 Диалоговое окно «Свойства элемента управления содержимым» .

Рис. 7. Назначение заголовка раздела в диалоговом окне «Свойства элемента управления содержимым»

После того, как вы присвоили разделу заголовок, выберите Разрешить пользователям добавлять и удалять разделы в Свойства элемента управления содержимым диалоговое окно, пользователи могут добавлять или удалять раздел по имени.

Рисунок 8. Использование контекстного меню управления содержимым повторяющегося раздела для удаления раздела

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

Рисунок 9. Элемент управления содержимым повторяющегося раздела, содержащий дочерние элементы управления, до повтора

Рисунок 10. Элемент управления содержимым повторяющегося раздела, содержащий дочерние элементы управления, после повтора

Элементы управления содержимым повторяющегося раздела вокруг элементов управления, сопоставленных с XML

Сопоставления XML, содержащиеся в повторяющемся разделе, Word 2013 сопоставляет их следующим образом.

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

Если отображение пересекается с элементом в наборе узлов как часть его родительской цепочки, привязка является «относительной привязкой» и переназначается следующим образом:

  • Определена абсолютная привязка для узла (выравнивание любых выражений запроса) — это должно произойти при начальном отображении

  • Ось привязки, которая пересекается с набором узлов, удалена

  • Остаток XPath оценивается относительно XPath элемента содержимого повторяющегося раздела

Например, могут возникнуть следующие сопоставления:

  • Повторяющийся раздел сопоставлен с \root\next\path

  • Элемент управления в примере элемента сопоставлен с \root\next\path[2]\baz

  • Word сопоставляет \root\next\path[2] с элементом в наборе узлов

Таким образом, привязка оценивается как . \baz, где базой является узел повторяющегося элемента содержимого.

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

Работа с элементами управления содержимым повторяющегося раздела, сопоставленными с данными XML

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

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

Привязка элемента управления содержимым повторяющегося раздела к таблице

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

Вложение элементов управления содержимым повторяющегося раздела в таблицу

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

Этого можно избежать, добавив маркер абзаца между концом одного элемента управления содержимым повторяющегося раздела и следующим. Чтобы скрыть маркер абзаца, снимите флажок Показать/скрыть на вкладке Главная ленты.

Дополнения к схеме формата файлов Open XML

В схему формата файлов WordprocessingML Open XML были добавлены следующие элементы.

Таблица 1. Новые элементы в схеме WordprocessingML Open XML File Format для элементов управления содержимым

Элемент Описание

является дочерним элементом . Для атрибута val допустимы следующие значения:

является дочерним элементом . Модель содержимого соответствует существующему сложному типу CT_Color. Значением по умолчанию является цвет, используемый в Word 2010.

Новые элементы объектной модели управления содержимым Word 2013

С новыми улучшениями и дополнениями к элементам управления содержимым в Word 2013 объектная модель для Word была обновлена, чтобы обеспечить возможность программного управления новым набором функций. Кроме того, были внесены изменения в базовый формат файлов Open XML для текстовых документов.

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

Улучшения визуализации

В Word 2013 включены несколько дополнений объектной модели для улучшения визуализации элементов управления содержимым. В следующей таблице перечислены новые члены объекта ContentControl для визуализации.

Таблица 2. Новые члены объекта ContentControl

Member Описание
. Внешний вид как WdContentControlAppearance
Получает или задает визуализацию элемента управления содержимым.
. Цвет как WdColor
Получает или задает цвет элемента управления содержимым.

В следующей таблице перечислены константы в новом перечислении WdContentControlAppearance .

Таблица 3. Новые константы перечисления WdContentControlAppearance

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

Пример кода

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

 ПодтестВизуализация()
   Dim objcc как ContentControl
   Затемнить objRange как диапазон
   
   ' Получить первый абзац как объект диапазона.
   Установите objRange = ActiveDocument.Paragraphs(1).Range
   ' Создайте элемент управления форматированным текстовым содержимым вокруг первого абзаца.
   Установить objcc = ActiveDocument.ContentControls.Add(wdContentControlRichText, objRange)
   objcc.Title = "Ограничивающая рамка по умолчанию"
   ' Установить визуализацию по умолчанию.
   objcc.Appearance = вдконтентконтролбаундингбокс
   
   'Создать новый абзац.
   objRange.InsertParagraphAfter
   Установите objRange = ActiveDocument.Paragraphs(2).Range
   ' Создайте элемент управления форматированным текстовым содержимым вокруг второго абзаца.
   Установить objcc = ActiveDocument.ContentControls.Add(wdContentControlRichText, objRange)
   objcc.Title = "Не ограничивающий"
   ' Сделать визуализацию невидимой.
   objcc.Appearance = вдконтентконтролхидден
   
   'Создать новый абзац. 
   objRange.InsertParagraphAfter
   Установите objRange = ActiveDocument.Paragraphs(3).Range
   ' Создайте элемент управления форматированным текстовым содержимым вокруг третьего абзаца.
   Установить objcc = ActiveDocument.ContentControls.Add(wdContentControlRichText, objRange)
   objcc.Title = "Теги только розового цвета"
   ' Установите визуализацию для тегов Start/End розового цвета.
   objcc.Appearance = вдконтентконтролтагс
   objcc.Color = вдколорпинк
Конец сабвуфера

Сопоставление XML

В объектную модель Word 2013 не было внесено никаких дополнений, связанных с сопоставлением форматированного текста с узлами XML в хранилище данных документа. Вместо этого используйте существующую объектную модель для сопоставления элемента управления форматированным текстовым содержимым с узлом XML в хранилище данных документа. Кроме того, не было внесено никаких изменений в базовую схему WordprocessingML в формате файлов Open XML в рамках недавно включенной поддержки элемента управления форматированным текстовым содержимым специально для сопоставления XML.

Образец кода

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

 ПодтестRichBinding()
   Затемнить objRange как диапазон
   Dim objcc как ContentControl
   Dim objCustomPart как CustomXMLPart
   Dim blnMap As Boolean
   
   ' Добавьте пользовательскую часть XML в хранилище данных.
   Установите objCustomPart = ActiveDocument.CustomXMLParts.Add
   ' Загрузить XML-фрагмент в пользовательскую XML-часть.
   objCustomPart.LoadXML ("Привязка форматированных текстовых данных")
   ' Получить первый абзац как объект диапазона.
   Установите objRange = ActiveDocument.Paragraphs(1).Range
   ' Создайте элемент управления форматированным текстовым содержимым вокруг первого абзаца.
   Установить objcc = ActiveDocument.ContentControls.Add(wdContentControlRichText, objRange)
   ' Привяжите узел XML к элементу управления форматированным текстовым содержимым.
   blnMap = objcc.XMLMapping.SetMapping("/x")
   ' Вернуть, сработало ли сопоставление. 
   MsgBox objcc.XMLMapping.IsMapped
Конец сабвуфера

Элементы управления содержимым повторяющегося раздела, представленные в объектной модели

Элемент управления содержимым повторяющегося раздела доступен в объектной модели с использованием следующих дополнений к объекту ContentControl и новым объектам RepeatingSectionItem и RepeatingSectionItemColl . В таблице 4 перечислены наиболее важные новые члены объекта ContentControl для элементов управления содержимым повторяющегося раздела.

Таблица 4. Члены объекта ContentControl

Участник Описание
AllowInsertDeleteSection как Boolean
Получает или задает, могут ли пользователи добавлять или удалять разделы из элемента управления содержимым с помощью пользовательского интерфейса. Если это свойство вызывается для элемента управления содержимым, не относящегося к типу повторяющегося раздела, вызов завершается сбоем со следующим сообщением об ошибке: «Это свойство можно использовать только с элементами управления содержимым повторяющегося раздела».
RepeatingSectionItemTitle как Строка
Получает или задает имя элементов повторяющегося раздела, используемых в контекстном меню. Если это свойство вызывается для элемента управления содержимым, не относящегося к типу повторяющегося раздела, вызов завершается с ошибкой: «Это свойство можно использовать только с элементами управления содержимым повторяющегося раздела».
InsertRepeatingSectionItemBefore as ContentControl
Добавляет элемент повторяющегося раздела перед текущим элементом и возвращает новый элемент повторяющегося раздела. Если этот метод вызывается для элемента управления содержимым, который не относится к элементу повторяющегося раздела, вызов завершается с ошибкой: «Это свойство можно использовать только с элементами управления содержимым повторяющегося элемента раздела».
InsertRepeatingSectionItemAfter как ContentControl
Добавляет элемент повторяющегося раздела после текущего элемента и возвращает новый элемент повторяющегося раздела. Если этот метод вызывается для элемента управления содержимым, который не относится к элементу повторяющегося раздела, вызов завершается с ошибкой: «Это свойство можно использовать только с элементами управления содержимым повторяющегося элемента раздела».

В таблице 5 перечислены наиболее важные члены объекта RepeatingSectionItem .

Таблица 5. Члены объекта RepeatingSectionItem

Член Описание
Диапазон как Диапазон
Возвращает диапазон указанного элемента повторяющегося раздела, исключая начальный и конечный теги.
Удалить
Удаляет указанный элемент повторяющегося раздела.
InsertItemAfter как RepeatingSectionItem
Добавляет элемент повторяющегося раздела после указанного элемента и возвращает новый элемент.
InsertItemBefore as RepeatingSectionItem
Добавляет элемент повторяющегося раздела перед указанным элементом и возвращает новый элемент.

В таблице 6 перечислены наиболее важные члены объекта RepeatingSectionItemColl .

Таблица 6. Члены объекта RepeatingSectionItemColl

Элемент Описание
Элемент как RepeatingSectionItem
Возвращает отдельный элемент повторяющегося раздела.

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

Таблица 7. Дополнение перечисления WdContentControlType

Константа Описание
wdContentControlRepeatingSection
Представляет элемент управления содержимым, содержащий один элемент в повторяющемся разделе.

Образец кода

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

 ПодтестRepeatingSectionControl()
   Затемнить objRange как диапазон
   Dim objTable как таблица
   Dim objCustomPart как CustomXMLPart
   Dim objCC как ContentControl
   Dim objCustomNode как CustomXMLNode
   
   Установите objCustomPart = ActiveDocument. CustomXMLParts.Add
   objCustomPart.LoadXML ("<книги>" & _
       "Итальянский на каждый день" и _
       "Джада Де Лаурентис" & _
       "Гарри Поттер" и _
       "Дж. К. Роулинг" и _
       "Изучение XML" и _
       "Эрик Т. Рэй")
   
   Установите objRange = ActiveDocument.Paragraphs(1).Range
   Установить objTable = ActiveDocument.Tables.Add(objRange, 2, 2)
   С objTable.Borders
       .InsideLineStyle = вдлинестилесингле
       .Аутсайделинстиле = вдлинестиледаубле
   Конец с
   Установите objRange = objTable.Cell(1, 1).Range
   Установить objCustomNode = objCustomPart.SelectSingleNode("/books[1]/book[1]/title[1]")
   Установите objCC = ActiveDocument.ContentControls.Add(wdContentControlText, objRange)
   objCC.XMLMapping.SetMappingByNode objCustomNode
   Установите objRange = objTable.Cell(1, 2).Range
   Установить objCustomNode = objCustomPart. SelectSingleNode("/books[1]/book[1]/author[1]")
   Установите objCC = ActiveDocument.ContentControls.Add(wdContentControlText, objRange)
   objCC.XMLMapping.SetMappingByNode objCustomNode
   Установите objRange = objTable.Rows(1).Range
   Установите objCC = ActiveDocument.ContentControls.Add(wdContentControlRepeatingSection, objRange)
   objCC.XMLMapping.SetMapping ("/книги[1]/книга")
Конец сабвуфера

Изменения формата файла Open XML для элементов управления содержимым повторяющегося раздела

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

Отдельные повторяющиеся элементы в элементе управления содержимым повторяющегося раздела (которые окружают каждый отдельный элемент) сохраняются как элементы управления форматированным текстовым содержимым с использованием существующего представления WordprocessingML. В таблице 8 перечислены новые элементы схемы WordprocessingML для элементов управления содержимым повторяющегося раздела.

Таблица 8. Новые элементы в схеме WordprocessingML для элементов управления содержимым повторяющегося раздела

Элемент Описание

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

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

 Указывает, что пользователь не может добавлять или удалять разделы с помощью пользовательского интерфейса Word 2013.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *