BuildingBlock Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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. |