BuildingBlock Interface

Définition

Espace de noms:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Représente un bloc de construction dans un modèle. Un bloc de construction est un contenu préconstruit, similaire à l'insertion automatique, qui peut contenir du texte, des images et une mise en forme.

public interface class BuildingBlock

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

type BuildingBlock = interface

Public Interface BuildingBlock

Attributs

GuidAttribute

Remarques

Chaque BuildingBlock objet est membre des BuildingBlocks collections et BuildingBlockEntries . Les blocs de construction sont stockés dans des modèles Microsoft Office Word. Par conséquent, pour accéder aux blocs de construction disponibles pour un document, vous devez accéder à un modèle attaché. Blocs de construction intégrés sont stockés dans le modèle nommé « Building Blocks.dotx ».

Remarque : utilisez la Item(Object) méthode de la collection ou de la BuildingBlocks collection pour retourner un bloc de construction individuel. [!REMARQUE] En fonction de la manière dont vous accédez à la collection, la collection renvoyée peut changer. Par exemple, si vous accédez à une collection de blocs de construction avec un type avec wdTypeAutoText une catégorie « Général », la collection retournée peut être différente de la collection retournée si vous accédez à une collection de blocs de construction avec un type de wdTypeAutoText avec une catégorie « Personnalisé ». Elle est également différente de la collection retournée si vous accédez à la collection de blocs de construction avec un type de wdTypeCustomAutoText avec une catégorie « Général ». Par conséquent, le premier élément dans une collection accédé à partir de la collection BuildingBlockEntries peut différer le premier élément dans la collection accédé depuis la collection BuildingBlocks.

Pour créer un nouveau bloc de construction, vous pouvez utiliser la méthode Add de la collection BuildingBlockEntries ou à la collection BuildingBlocks. Toutefois, la méthode recommandée pour créer un bloc de construction consiste à utiliser la Add(String, WdBuildingBlockTypes, String, Range, Object, WdDocPartInsertOptions) méthode pour la collection BuildingBlockEntries .

Utilisez la Insert(Range, Object) méthode pour insérer un nouveau bloc de construction dans un document. Utilisez la Delete() méthode pour supprimer un bloc de construction d’un modèle.

Blocs de construction sont organisés par catégorie et type. Utilisez la BuildingBlockTypes collection pour accéder à des objets individuels BuildingBlockType . Utilisez la Categories collection pour accéder à des objets individuels Category . Ensuite, utilisez la propriété BuildingBlocks pour accéder à la collection BuildingBlocks pour un objet Category.

Chaque bloc de construction a des propriétés qui contiennent des informations qui s’appliquent de manière unique, telles que Name, Description, Typeet Value.

Pour plus d’informations sur les blocs de construction, consultez Utilisation des blocs de construction

Propriétés

Application	Renvoie un _Application objet qui représente l’application Microsoft Word.
Category	Retourne la catégorie d’un bloc de construction. En lecture seule.
Creator	Renvoie un entier 32 bits qui indique l'application dans laquelle le complément a été créé. En lecture seule.
Description	Renvoie ou définit la description d’un bloc de construction. Lecture-écriture.
ID	Retourne le numéro d’identification interne d’un bloc de construction. En lecture seule.
Index	Retourne la position d’un élément dans une collection. En lecture seule.
InsertOptions	Renvoie ou définit une valeur de type Integer qui indique comment insérer le contenu d’un bloc de construction dans un document. Lecture-écriture.
Name	Renvoie ou définit le nom d’un bloc de construction. Lecture-écriture.
Parent	Retourne l’objet parent de l’objet spécifié BuildingBlock .
Type	Retourne le type d’un bloc de construction. En lecture seule.
Value	Renvoie ou définit le contenu d’un bloc de construction. Lecture-écriture.

Méthodes

Delete()	Supprime le bloc de construction spécifié.
Insert(Range, Object)	Insère la valeur d’un bloc de construction dans un document et renvoie un Range objet qui représente le contenu du bloc de construction dans le document.