Freigeben über


BuildingBlockGalleryContentControl-Schnittstelle

Stellt einen Katalog von Dokumentbausteinen dar, die Benutzer in ein Dokument einfügen können.

Namespace:  Microsoft.Office.Tools.Word
Assembly:  Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
<GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")> _
Public Interface BuildingBlockGalleryContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize
[GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

Der BuildingBlockGalleryContentControl-Typ macht die folgenden Member verfügbar.

Eigenschaften

  Name Beschreibung
Öffentliche Eigenschaft Application Ruft eine Microsoft.Office.Interop.Word.Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.
Öffentliche Eigenschaft BindingContext Ruft die Auflistung von CurrencyManager-Objekten für die IBindableComponent ab oder legt diese fest. (Von IBindableComponent geerbt.)
Öffentliche Eigenschaft BuildingBlockCategory Ruft die Kategorie der Bausteine ab, die im BuildingBlockGalleryContentControl angezeigt werden, oder legt die Kategorie fest.
Öffentliche Eigenschaft BuildingBlockType Ruft den Typ der Bausteine ab, die im BuildingBlockGalleryContentControl angezeigt werden, oder legt den Typ fest.
Öffentliche Eigenschaft Container Infrastruktur. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft ContainerComponent Infrastruktur. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft Creator Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das BuildingBlockGalleryContentControl-Element erstellt wurde.
Öffentliche Eigenschaft DataBindings Ruft die Auflistung der Datenbindungsobjekte für diese IBindableComponent ab. (Von IBindableComponent geerbt.)
Öffentliche Eigenschaft DefaultDataSourceUpdateMode Ruft den Standard-DataSourceUpdateMode für den ContentControlBase ab oder legt diesen fest. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft DefaultTextStyle Ruft den Namen des Zeichenstils ab, der verwendet wird, um im BuildingBlockGalleryContentControl Text zu formatieren, oder legt den Namen fest.
Öffentliche Eigenschaft ID Ruft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft InnerObject Ruft das zugrunde liegende Microsoft.Office.Interop.Word.ContentControl-Objekt für das Microsoft.Office.Tools.Word.ContentControlBase ab. (Von ContentControlBase geerbt.)
Öffentliche Eigenschaft LockContentControl Ruft einen Wert ab, der angibt, ob das BuildingBlockGalleryContentControl aus dem Dokument gelöscht werden kann, oder legt den Wert fest.
Öffentliche Eigenschaft LockContents Ruft einen Wert ab, der angibt, ob der Inhalt vom BuildingBlockGalleryContentControl bearbeitet werden kann, oder legt den Wert fest.
Öffentliche Eigenschaft Parent Ruft das übergeordnete Element der BuildingBlockGalleryContentControl ab.
Öffentliche Eigenschaft ParentContentControl Ruft das übergeordnete Inhaltssteuerelement von einem BuildingBlockGalleryContentControl ab, das in einem anderen Inhaltselement geschachtelt ist.
Öffentliche Eigenschaft PlaceholderText Ruft den Text ab, der im BuildingBlockGalleryContentControl angezeigt wird, bis der Text durch eine Benutzeraktion oder einen anderen Vorgang geändert wird, oder legt den Text fest.
Öffentliche Eigenschaft Range Ruft ein Range-Element ab, das den Inhalt des BuildingBlockGalleryContentControl-Elements darstellt.
Öffentliche Eigenschaft ShowingPlaceholderText Ruft einen Wert ab, der angibt, ob das BuildingBlockGalleryContentControl derzeit Platzhaltertext anzeigt.
Öffentliche Eigenschaft Site Ruft den dem IComponent zugeordneten ISite ab oder legt diesen fest. (Von IComponent geerbt.)
Öffentliche Eigenschaft Tag Ruft eine Zeichenfolge ab, die Sie dem BuildingBlockGalleryContentControl zuordnen, oder legt eine Zeichenfolge fest.
Öffentliche Eigenschaft Temporary Ruft einen Wert ab, der angibt, ob das BuildingBlockGalleryContentControl bei Bearbeitung des Steuerelements automatisch aus dem Dokument gelöscht wird, oder legt den Wert fest.
Öffentliche Eigenschaft Text Ruft den Text im BuildingBlockGalleryContentControl ab oder legt ihn fest.
Öffentliche Eigenschaft Title Ruft den Titel für das BuildingBlockGalleryContentControl ab oder legt diesen fest.

Zum Seitenanfang

Methoden

  Name Beschreibung
Öffentliche Methode BeginInit Signalisiert dem Objekt den Start der Initialisierung. (Von ISupportInitialize geerbt.)
Öffentliche Methode Copy Kopiert das BuildingBlockGalleryContentControl aus dem Dokument in die Zwischenablage.
Öffentliche Methode Cut Entfernt das BuildingBlockGalleryContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.
Öffentliche Methode Delete Löscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument. (Von ContentControlBase geerbt.)
Öffentliche Methode Dispose Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurückgeben oder Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. (Von IDisposable geerbt.)
Öffentliche Methode EndInit Signalisiert dem Objekt den Abschluss der Initialisierung. (Von ISupportInitialize geerbt.)
Öffentliche Methode SetPlaceholderText Zeigt Text an, der sich in einem Microsoft.Office.Interop.Word.BuildingBlock, einem Range oder in einer Zeichenfolge als Platzhaltertext im BuildingBlockGalleryContentControl befindet.

Zum Seitenanfang

Ereignisse

  Name Beschreibung
Öffentliches Ereignis Added Tritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde. (Von ContentControlBase geerbt.)
Öffentliches Ereignis BindingContextChanged Tritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird. (Von ContentControlBase geerbt.)
Öffentliches Ereignis ContentUpdating Tritt auf, kurz bevor Microsoft Office Word den Text im Inhaltssteuerelement aktualisiert, wenn das Inhaltssteuerelement an einen benutzerdefinierten XML-Abschnitt gebunden ist. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Deleting Tritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Disposed Stellt die Methode dar, die das Disposed-Ereignis einer Komponente behandelt. (Von IComponent geerbt.)
Öffentliches Ereignis Entering Tritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Exiting Tritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird. (Von ContentControlBase geerbt.)
Öffentliches Ereignis StoreUpdating Tritt auf, kurz bevor Microsoft Office Word Daten in einem benutzerdefinierten XML-Abschnitt aktualisiert, der an das Inhaltssteuerelement gebunden ist (nachdem der Text im Inhaltssteuerelement sich ändert). (Von ContentControlBase geerbt.)
Öffentliches Ereignis Validated Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde. (Von ContentControlBase geerbt.)
Öffentliches Ereignis Validating Tritt auf, wenn der Inhalt des Inhaltssteuerelements überprüft wird. (Von ContentControlBase geerbt.)

Zum Seitenanfang

Hinweise

Ein BuildingBlockGalleryContentControl zeigt eine Liste von Dokumentbausteinen an, die Benutzer in ein Dokument einfügen können. Ein Dokumentbaustein ist ein Inhaltselement, das zur mehrmaligen Verwendung erstellt wurde, beispielsweise eine allgemeine Titelseite, eine formatierte Tabelle oder ein Header. Um die Bausteine auszuwählen, die Sie anzeigen möchten, verwenden Sie die BuildingBlockCategory-Eigenschaft und die BuildingBlockType-Eigenschaft.

Weitere Informationen über Dokumentbausteine finden Sie unter Neues für Entwickler in Word 2007.

Hinweis

Diese Schnittstelle wird von der Visual Studio-Tools für Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

Inhaltssteuerelemente

Das BuildingBlockGalleryContentControl ist einer von acht Steuerelementtypen, die Sie in Microsoft Office Word zum Entwerfen von Dokumenten und Vorlagen verwenden können. Inhaltssteuerelemente haben eine Benutzeroberfläche mit verwalteten Benutzereingaben wie bei einem Formular. Sie können mithilfe von Inhaltssteuerelementen verhindern, dass Benutzer geschützte Abschnitte des Dokuments bzw. der Vorlage bearbeiten. Außerdem können Sie Inhaltssteuerelemente an eine Datenquelle binden. Weitere Informationen finden Sie unter Inhaltssteuerelemente.

Verwendung

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und .NET Framework 4.5 ausgerichtet sind. In Projekten, die auf .NET Framework 3.5 abzielen, verfügt dieser Typ möglicherweise über unterschiedliche Member, und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.

Beispiele

Im folgenden Codebeispiel wird am Anfang des Dokuments ein neues BuildingBlockGalleryContentControl hinzugefügt. Das BuildingBlockGalleryContentControl zeigt Formelbausteine an, die von Microsoft Office Word bereitgestellt werden.

Diese Version bezieht sich auf eine Anpassung auf Dokumentebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisDocument-Klasse im Projekt ein, und rufen Sie in der ThisDocument_Startup-Methode die AddBuildingBlockControlAtSelection-Methode auf.

Dim buildingBlockGalleryControl1 As Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    buildingBlockGalleryControl1 = Me.Controls.AddBuildingBlockGalleryContentControl( _
        "buildingBlockGalleryControl1")
    With buildingBlockGalleryControl1
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub
private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;

private void AddBuildingBlockControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    buildingBlockControl1 = this.Controls.AddBuildingBlockGalleryContentControl(
        "buildingBlockControl1");
    buildingBlockControl1.PlaceholderText = "Choose an equation";
    buildingBlockControl1.BuildingBlockCategory = "Built-In";
    buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}

Diese Version bezieht sich auf ein Add-In auf Anwendungsebene. Zum Verwenden dieses Codes fügen Sie ihn in der ThisAddIn-Klasse im Projekt ein, und rufen Sie in der ThisAddIn_Startup-Methode die AddBuildingBlockControlAtSelection-Methode auf.

Dim buildingBlockGalleryControl1 As BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    buildingBlockGalleryControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl( _
        "buildingBlockGalleryControl1")
    With buildingBlockGalleryControl1
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub
private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl1;

private void AddBuildingBlockControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    buildingBlockControl1 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl(
        "buildingBlockControl1");
    buildingBlockControl1.PlaceholderText = "Choose an equation";
    buildingBlockControl1.BuildingBlockCategory = "Built-In";
    buildingBlockControl1.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}

Siehe auch

Referenz

Microsoft.Office.Tools.Word-Namespace

Weitere Ressourcen

Inhaltssteuerelemente

Gewusst wie: Hinzufügen von Inhaltssteuerelementen zu Word-Dokumenten

Gewusst wie: Schützen von Teilen von Dokumenten mithilfe von Inhaltssteuerelementen

Exemplarische Vorgehensweise: Erstellen einer Vorlage mithilfe von Inhaltssteuerelementen