BuildingBlock Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет стандартный блок в шаблоне. Стандартный блок — это предварительно созданное содержимое, похожее на автотекст, которое может содержать текст, изображения и форматирование.
public interface class BuildingBlock
[System.Runtime.InteropServices.Guid("BFD3FC23-F763-4FF8-826E-1AFBF598A4E7")]
public interface BuildingBlock
type BuildingBlock = interface
Public Interface BuildingBlock
- Атрибуты
Комментарии
Каждый BuildingBlock объект является членом коллекций BuildingBlocks и BuildingBlockEntries . Стандартные блоки хранятся в шаблонах Microsoft Office Word. Поэтому для доступа к стандартным блокам, доступным для документа, необходимо получить доступ к присоединенному шаблону. Встроенные стандартные блоки хранятся в шаблоне "Стандартные блоки.dotx".
Примечание. Используйте Item(Object) метод коллекции или коллекции, BuildingBlocks чтобы вернуть отдельный стандартный блок. В зависимости от того, как вы обращаетесь к коллекции, возвращаемая коллекция может измениться. Например, если вы обращаетесь к коллекции стандартных блоков с типом wdTypeAutoText с категорией "Общие", возвращаемая коллекция может отличаться от возвращаемой коллекции, если вы обращаетесь к коллекции стандартных блоков с типом wdTypeAutoText с категорией "Custom". Он также отличается от коллекции, возвращаемой при доступе к коллекции стандартных блоков с типом wdTypeCustomAutoText с категорией "Общие". Таким образом, первый элемент в коллекции, доступ к который получен из коллекции BuildingBlockEntries , может отличаться от первого элемента в коллекции, доступ к который получен из коллекции BuildingBlocks .
Чтобы создать новый стандартный блок, можно использовать метод Add для коллекции BuildingBlockEntries или BuildingBlocks . Однако рекомендуется создать новый стандартный блок с помощью Add(String, WdBuildingBlockTypes, String, Range, Object, WdDocPartInsertOptions) метода для коллекции BuildingBlockEntries .
Используйте метод для Insert(Range, Object) вставки нового стандартного блока в документ. Используйте метод для Delete() удаления стандартного блока из шаблона.
Стандартные блоки упорядочены по категориям и типам. Используйте коллекцию BuildingBlockTypes для доступа к отдельным BuildingBlockType объектам. Используйте коллекцию Categories для доступа к отдельным Category объектам. Затем используйте свойство BuildingBlocks для доступа к коллекции BuildingBlocks для объекта Category .
Каждый стандартный блок имеет свойства, содержащие сведения, которые применяются к нему уникально, например Name, Description, Typeи Value.
Дополнительные сведения о стандартных блоках см. в статье Работа со стандартными блоками.
Свойства
Application |
_Application Возвращает объект , представляющий приложение Microsoft Word. |
Category |
Возвращает категорию для стандартного блока. Только для чтения. |
Creator |
Возвращает 32-разрядное целое число, указывающее приложение, в котором была создана надстройка. Только для чтения. |
Description |
Возвращает или задает описание стандартного блока. Для чтения и записи. |
ID |
Возвращает внутренний идентификационный номер для стандартного блока. Только для чтения. |
Index |
Возвращает позицию элемента в коллекции. Только для чтения. |
InsertOptions |
Возвращает или задает целое число , представляющее способ вставки содержимого стандартного блока в документ. Для чтения и записи. |
Name |
Возвращает или задает имя стандартного блока. Для чтения и записи. |
Parent |
Возвращает родительский объект указанного BuildingBlock объекта. |
Type |
Возвращает тип для стандартного блока. Только для чтения. |
Value |
Возвращает или задает содержимое стандартного блока. Для чтения и записи. |
Методы
Delete() |
Удаляет указанный стандартный блок. |
Insert(Range, Object) |
Вставляет значение стандартного блока в документ и возвращает Range объект, представляющий содержимое стандартного блока в документе. |