BuildingBlockGalleryContentControl Schnittstelle

Definition

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

[System.Runtime.InteropServices.Guid("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
Attribute
Implementiert

Beispiele

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

Diese Version ist für eine Anpassung auf Dokument Ebene vorgesehen. Um diesen Code zu verwenden, fügen Sie ihn in die ThisDocument -Klasse in Ihrem Projekt ein, und nennen Sie die- AddBuildingBlockControlAtSelection Methode von der- ThisDocument_Startup Methode.

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;
}
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

Diese Version ist für ein Add-in auf Anwendungsebene vorgesehen. Um diesen Code zu verwenden, fügen Sie ihn in die ThisAddIn -Klasse in Ihrem Projekt ein, und nennen Sie die- AddBuildingBlockControlAtSelection Methode von der- ThisAddIn_Startup Methode.

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;
}
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

Hinweise

BuildingBlockGalleryContentControlZeigt eine Liste von Dokument Bausteinen an, die Benutzer in ein Dokument einfügen können. Ein Dokumentbaustein ist ein Inhaltselement, das erstellt wurde, um mehrere Male verwendet zu werden, z. B. eine allgemeine Titelseite, eine formatierte Tabelle oder ein Header . Zum Auswählen der Bausteine, die Sie anzeigen möchten, verwenden Sie die BuildingBlockCategory -Eigenschaft und die-Eigenschaft BuildingBlockType .

Weitere Informationen zu Dokument Bausteinen finden Sie unter What es New for Developers 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 Visual Studio Tools for Office Runtime Overview.

Inhaltssteuerelemente

Der BuildingBlockGalleryContentControl ist einer von acht Typen von Inhalts Steuerelementen, die Sie zum Entwerfen von Dokumenten und Vorlagen in Microsoft Office Word verwenden können. Inhalts Steuerelemente verfügen über eine Benutzeroberfläche (UI), die über kontrollierte Eingaben wie ein Formular verfügt. Sie können Inhalts Steuerelemente verwenden, um zu verhindern, dass Benutzer geschützte Abschnitte des Dokuments oder der Vorlage bearbeiten, und Sie können Inhalts Steuerelemente auch an eine Datenquelle binden. Weitere Informationen finden Sie unter Content Controls.

Verwendung

Diese Dokumentation beschreibt die Version des Typs, der in Office-Projekten verwendet wird, die auf .NET Framework 4 und höher 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. Eine Dokumentation dieser Art von Projekten, die auf den .NET Framework 3.5 abzielen, erhalten Sie in den folgenden Verweisabschnitten in der Dokumentation zu Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Eigenschaften

Application

Ruft eine Application ab, die die aktuelle Instanz von Microsoft Office Word darstellt.

BuildingBlockCategory

Ruft die Kategorie der Bausteine ab, die im BuildingBlockGalleryContentControl angezeigt werden, oder legt die Kategorie fest.

BuildingBlockType

Ruft den Typ der Bausteine ab, die im BuildingBlockGalleryContentControl angezeigt werden, oder legt den Typ fest.

Container (Geerbt von ContentControlBase)
ContainerComponent (Geerbt von ContentControlBase)
Creator

Ruft eine 32-Bit-Ganzzahl ab, die die Anwendung angibt, in der das BuildingBlockGalleryContentControl erstellt wurde.

DefaultDataSourceUpdateMode

Ruft den Standard-DataSourceUpdateMode für das ContentControlBase ab oder legt diesen fest.

(Geerbt von ContentControlBase)
DefaultTextStyle

Ruft den Namen des Zeichenstils ab, der verwendet wird, um im BuildingBlockGalleryContentControl Text zu formatieren, oder legt den Namen fest.

ID

Ruft eine eindeutige Zahl ab, die das Inhaltssteuerelement identifiziert.

(Geerbt von ContentControlBase)
InnerObject

Ruft das zugrunde liegende ContentControl-Objekt für ContentControlBase ab.

(Geerbt von ContentControlBase)
LockContentControl

Ruft einen Wert ab, der angibt, ob das BuildingBlockGalleryContentControl aus dem Dokument gelöscht werden kann, oder legt diesen Wert fest.

LockContents

Ruft einen Wert ab, der angibt, ob die Inhalte des BuildingBlockGalleryContentControl bearbeitet werden können, oder legt diesen Wert fest.

Parent

Ruft das übergeordnete Element von BuildingBlockGalleryContentControl ab.

ParentContentControl

Ruft das übergeordnete Inhaltssteuerelement von einem BuildingBlockGalleryContentControl ab, das in einem anderen Inhaltselement geschachtelt ist.

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.

Range

Ruft einen Range ab, der den Inhalt von BuildingBlockGalleryContentControl darstellt.

ShowingPlaceholderText

Ruft einen Wert ab, der angibt, ob das BuildingBlockGalleryContentControl derzeit Platzhaltertext anzeigt.

Tag

Ruft eine Zeichenfolge ab, die Sie dem BuildingBlockGalleryContentControl zuordnen möchten, oder legt eine Zeichenfolge fest.

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.

Text

Ruft den Text im BuildingBlockGalleryContentControl ab oder legt ihn fest.

Title

Ruft den Titel für das BuildingBlockGalleryContentControl ab oder legt diesen fest.

Methoden

Copy()

Kopiert das BuildingBlockGalleryContentControl aus dem Dokument in die Zwischenablage.

Cut()

Entfernt das BuildingBlockGalleryContentControl aus dem Dokument und fügt es der Zwischenablage hinzu.

Delete(Boolean)

Löscht ein dynamisch erstelltes Inhaltssteuerelement aus dem Dokument und entfernt es aus der ControlCollection im Dokument.

(Geerbt von ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)

Zeigt Text an, der sich in einem BuildingBlock, einem Range oder in einer Zeichenfolge als Platzhaltertext im BuildingBlockGalleryContentControl befindet.

Ereignisse

Added

Tritt auf, nachdem dem Dokument das Inhaltssteuerelement hinzugefügt wurde.

(Geerbt von ContentControlBase)
BindingContextChanged

Tritt ein, wenn der Wert der BindingContext-Eigenschaft des ContentControlBase geändert wird.

(Geerbt von ContentControlBase)
ContentUpdating

Tritt auf, kurz bevor Microsoft Office Word den Text im Inhaltssteuerelement aktualisiert, wenn das Inhaltssteuerelement an einen benutzerdefinierten XML-Abschnitt gebunden ist.

(Geerbt von ContentControlBase)
Deleting

Tritt kurz vor dem Löschen des Inhaltssteuerelements aus dem Dokument auf.

(Geerbt von ContentControlBase)
Entering

Tritt auf, wenn der Benutzer in das Inhaltssteuerelement klickt oder der Cursor programmgesteuert in das Inhaltssteuerelement bewegt wird.

(Geerbt von ContentControlBase)
Exiting

Tritt auf, wenn der Benutzer außerhalb des Inhaltssteuerelements klickt oder der Cursor programmgesteuert aus dem Inhaltssteuerelement heraus bewegt wird.

(Geerbt von ContentControlBase)
StoreUpdating

Tritt auf, kurz bevor Microsoft Office Word automatisch die Daten in einem benutzerdefinierten XML-Abschnitt aktualisiert, der an das Inhaltssteuerelement gebunden ist (d.h. nachdem sich der Text im Inhaltssteuerelement ändert).

(Geerbt von ContentControlBase)
Validated

Tritt ein, wenn das Inhaltssteuerelement erfolgreich überprüft wurde.

(Geerbt von ContentControlBase)
Validating

Tritt auf, wenn der Inhalt des Inhaltssteuerelements überprüft wird.

(Geerbt von ContentControlBase)

Gilt für