BuildingBlock Interface

Definição

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Representa um bloco de construção em um modelo. Um bloco de construção é um conteúdo pré-incorporado, similar ao autotexto, que pode conter texto, imagens e formatação.

public interface class BuildingBlock

[System.Runtime.InteropServices.Guid("BFD3FC23-F763-4FF8-826E-1AFBF598A4E7")]
public interface BuildingBlock

type BuildingBlock = interface

Public Interface BuildingBlock

Atributos

GuidAttribute

Comentários

Cada BuildingBlock objeto é um membro das BuildingBlocks coleções e BuildingBlockEntries . Os blocos de construção são armazenados nos modelos de Word do Microsoft Office. Portanto, para acessar os blocos de construção disponíveis para um documento, você precisa acessar um modelo anexado. Blocos de construção internos são armazenados no modelo denominado "Criando Blocks".

Observação: use o Item(Object) método da coleção ou da BuildingBlocks coleção para retornar um bloco de construção individual. [!OBSERVAçãO] Dependendo de como você pode acessar a coleção, a coleção retornada pode ser alteradas. Por exemplo, se você acessar uma coleção de blocos de construção com um tipo de wdTypeAutoText com uma categoria de "Geral", a coleção retornada poderá ser diferente da coleção retornada se você acessar uma coleção de blocos de construção com um tipo de wdTypeAutoText com uma categoria de "Personalizado". Também é diferente da coleção retornada se você acessar a coleção de blocos de construção com um tipo de wdTypeCustomAutoText com uma categoria de "Geral". Portanto, o primeiro item em uma coleção acessada a partir da coleção BuildingBlockEntries pode ser diferente do primeiro item na coleção acessada a partir da coleção BuildingBlocks.

Para criar um novo bloco de construção, você pode usar o método Add da coleção BuildingBlockEntries ou da coleção BuildingBlocks. No entanto, a maneira recomendada de criar um novo bloco de construção é usando o Add(String, WdBuildingBlockTypes, String, Range, Object, WdDocPartInsertOptions) método para a coleção BuildingBlockEntries .

Use o Insert(Range, Object) método para inserir um novo bloco de construção em um documento. Use o Delete() método para remover um bloco de construção de um modelo.

Blocos de construção são organizados por categoria e tipo. Use a BuildingBlockTypes coleção para acessar objetos individuais BuildingBlockType . Use a Categories coleção para acessar objetos individuais Category . Use a propriedade BuildingBlocks para acessar a coleção BuildingBlocks para um objeto Category.

Cada bloco de construção tem propriedades que contêm informações que se aplicam exclusivamente a ele, como Name, Description, Typee Value.

Para obter mais informações sobre blocos de construção, consulte Trabalhando com blocos de construção

Propriedades

Application	Retorna um _Application objeto que representa o aplicativo microsoft Word.
Category	Retorna a categoria para um bloco de construção. Somente leitura.
Creator	Retorna um inteiro de 32 bits que indica o aplicativo no qual o suplemento foi criado. Somente leitura.
Description	Retorna ou define a descrição de um bloco de construção. Leitura/gravação.
ID	Retorna o número de identificação interna de um bloco de construção. Somente leitura.
Index	Retorna a posição de um item em uma coleção. Somente leitura.
InsertOptions	Retorna ou define um Inteiro que representa como inserir o conteúdo de um bloco de construção em um documento. Leitura/gravação.
Name	Retorna ou define o nome de um bloco de construção. Leitura/gravação.
Parent	Retorna o objeto pai do objeto especificado BuildingBlock .
Type	Retorna o tipo de um bloco de construção. Somente leitura.
Value	Retorna ou define o conteúdo de um bloco de construção. Leitura/gravação.

Métodos

Delete()	Exclui o bloco de construção especificado.
Insert(Range, Object)	Insere o valor de um bloco de construção em um documento e retorna um Range objeto que representa o conteúdo do bloco de construção dentro do documento.