BuildingBlock 接口

  • 参考

定义

命名空间:
Microsoft.Office.Interop.Word
程序集:
Microsoft.Office.Interop.Word.dll

代表模板中的构建基块。 构建基块是预先构建的内容，类似于自动图文集，其中可能包含文本、图像和格式。

public interface class BuildingBlock
[System.Runtime.InteropServices.Guid("BFD3FC23-F763-4FF8-826E-1AFBF598A4E7")]
public interface BuildingBlock
type BuildingBlock = interface
Public Interface BuildingBlock
属性
GuidAttribute

注解

每个BuildingBlock对象都是 和 BuildingBlockEntries 集合的成员BuildingBlocks。 构建基块存储在 Microsoft Office Word 模板中。 因此，要访问文档可用的构建基块，需要访问附加的模板。 内置构建基块存储在名为“Building Blocks.dotx”的模板中。

注意：使用 Item(Object) 集合或 BuildingBlocks 集合的 方法可返回单个构建基块。 根据访问集合的方式，返回的集合可能会更改。 例如，如果访问的 wdTypeAutoText 构建基块集合的类型为“常规”，则返回的集合可能与返回的集合不同，前提是访问类型 wdTypeAutoText 为 的构建基块的集合，该集合的类型为“Custom”。 如果访问类型 wdTypeCustomAutoText 为“常规”的 构建基块集合，则它与返回的集合也不同。 因此，从 BuildingBlockEntries 集合访问的集合中的第一项可能与从 BuildingBlocks 集合访问的集合中的第一项不同。

要创建新的构建基块，可以使用 BuildingBlockEntries 集合或 BuildingBlocks 集合的 Add 方法。 但是，创建新的构建基块的建议方法是使用 Add(String, WdBuildingBlockTypes, String, Range, Object, WdDocPartInsertOptions)BuildingBlockEntries 集合的 方法。

Insert(Range, Object)使用 方法将新的构建基块插入文档中。 Delete()使用 方法从模板中删除构建基块。

构建基块按类别和类型进行组织。 使用 BuildingBlockTypes 集合访问单个 BuildingBlockType 对象。 使用 Categories 集合访问单个 Category 对象。 然后使用 BuildingBlocks 权限访问 Category 对象的 BuildingBlocks 集合。

每个构建基块都有属性，这些属性包含唯一应用于它的信息，例如 Name、 Description、 Type和 Value。

有关构建基块的详细信息，请参阅 使用构建基块

属性

Application

返回一个_Application对象，该对象表示 Microsoft Word 应用程序。
Category

返回构建基块的类别。 此为只读属性。
Creator

返回一个 32 位整数，它指示在其中创建外接程序的应用程序。 此为只读属性。
Description

返回或设置构建基块的说明。 读/写。
ID

返回构建基块的内部标识号。 此为只读属性。
Index

返回项在集合中的位置。 此为只读属性。
InsertOptions

返回或设置一个 Integer 类型的值，该值代表如何将构建基块的内容插入文档中。 读/写。
Name

返回或设置构建基块的名称。 读/写。
Parent

返回指定 BuildingBlock 对象的父对象。
Type

返回构建基块的类型。 此为只读属性。
Value

返回或设置构建基块的内容。 读/写。

方法

Delete()

删除指定的生成块。
Insert(Range, Object)

将构建基块的值插入到文档中，并返回一个 Range 对象，该对象代表文档中构建基块的内容。

适用于