BuildingBlock Schnittstelle

Definition

Namespace:

Microsoft.Office.Interop.Word

Assembly:

Microsoft.Office.Interop.Word.dll

Stellt einen Baustein in einer Vorlage dar. Ein Baustein ist vordefinierter Inhalt, ähnlich AutoText, der Text, Bilder und Formatierung enthalten kann.

public interface class BuildingBlock

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

type BuildingBlock = interface

Public Interface BuildingBlock

Attribute

GuidAttribute

Hinweise

Jedes BuildingBlock Objekt ist ein Element der BuildingBlocks Auflistungen und BuildingBlockEntries . Bausteine werden in Microsoft Office Word-Vorlagen gespeichert. Daher benötigen Sie Zugriff auf eine zugeordnete Vorlage, um auf die für ein Dokument verfügbaren Bausteine zugreifen zu können. Integrierte Bausteine sind in der Vorlage mit dem Namen "Building Blocks.dotx" gespeichert.

Hinweis: Verwenden Sie die Item(Object) -Methode der -Auflistung oder - BuildingBlocks Auflistung, um einen einzelnen Baustein zurückzugeben. Je nachdem, wie Sie auf die Sammlung zugreifen, kann sich die zurückgegebene Sammlung ändern. Wenn Sie beispielsweise auf eine Auflistung von Bausteinen mit dem Typ mit der wdTypeAutoText Kategorie "Allgemein" zugreifen, kann sich die zurückgegebene Sammlung von der zurückgegebenen Sammlung unterscheiden, wenn Sie auf eine Auflistung von Bausteinen mit dem Typ mit wdTypeAutoText der Kategorie "Benutzerdefiniert" zugreifen. Sie unterscheidet sich auch von der zurückgegebenen Auflistung, wenn Sie auf die Auflistung von Bausteinen mit dem Typ von wdTypeCustomAutoText mit der Kategorie "Allgemein" zugreifen. Daher kann sich das erste Element in einer Auflistung, auf das über die BuildingBlockEntries-Auflistung zugegriffen wird, vom ersten Element in der Auflistung unterscheiden, auf das über die BuildingBlocks-Auflistung zugegriffen wird.

Zum Erstellen eines neuen Bausteins können Sie die Add-Methode der BuildingBlockEntries-Auflistung oder der BuildingBlocks-Auflistung verwenden. Die empfohlene Methode zum Erstellen eines neuen Bausteins ist jedoch die Verwendung der Add(String, WdBuildingBlockTypes, String, Range, Object, WdDocPartInsertOptions) -Methode für die BuildingBlockEntries-Auflistung .

Verwenden Sie die Insert(Range, Object) -Methode, um einen neuen Baustein in ein Dokument einzufügen. Verwenden Sie die Delete() -Methode, um einen Baustein aus einer Vorlage zu entfernen.

Building blocks are organized by category and type. Verwenden Sie die BuildingBlockTypes Auflistung, um auf einzelne BuildingBlockType Objekte zuzugreifen. Verwenden Sie die Categories Auflistung, um auf einzelne Category Objekte zuzugreifen. Then use the BuildingBlocks propery to access the BuildingBlocks collection for a Category object.

Jeder Baustein verfügt über Eigenschaften, die Informationen enthalten, die eindeutig auf ihn angewendet werden, z Name. B. , Description, Typeund Value.

Weitere Informationen zu Bausteinen finden Sie unter Arbeiten mit Bausteinen.

Eigenschaften

Application	Gibt ein _Application Objekt zurück, das die Microsoft Word-Anwendung darstellt.
Category	Gibt die Kategorie für einen Baustein zurück. Schreibgeschützt.
Creator	Gibt eine 32-Bit-Ganzzahl zurück, die auf die Anwendung verweist, in der das Add-In erstellt wurde. Schreibgeschützt.
Description	Gibt die Beschreibung für einen Baustein zurück oder legt sie fest. Lese-/Schreibzugriff.
ID	Gibt die interne Identifikationsnummer für einen Baustein zurück. Schreibgeschützt.
Index	Gibt die Position eines Elements in einer Auflistung zurück. Schreibgeschützt.
InsertOptions	Gibt einen Wert vom Typ Integer zurück, der darstellt, wie der Inhalt eines Bausteins in ein Dokument eingefügt wird, oder legt diesen Wert fest. Lese-/Schreibzugriff.
Name	Gibt den Namen eines Bausteins zurück oder legt den Namen fest. Lese-/Schreibzugriff.
Parent	Gibt das übergeordnete Objekt des angegebenen BuildingBlock Objekts zurück.
Type	Gibt den Typ für einen Baustein zurück. Schreibgeschützt.
Value	Gibt den Inhalt eines Bausteins zurück oder legt den Inhalt fest. Lese-/Schreibzugriff.

Methoden

Delete()	Löscht den angegebenen Baustein.
Insert(Range, Object)	Fügt den Wert eines Bausteins in ein Dokument ein und gibt ein Range -Objekt zurück, das den Inhalt des Bausteins im Dokument darstellt.