ControlCollection.AddBuildingBlockGalleryContentControl Metoda

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools.Word

Zestawy:: Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

AddBuildingBlockGalleryContentControl(String)	Dodaje nowy BuildingBlockGalleryContentControl element do bieżącego zaznaczenia w dokumencie.
AddBuildingBlockGalleryContentControl(ContentControl, String)	Dodaje nowy BuildingBlockGalleryContentControl element do kolekcji. Nowy formant opiera się na macierzystym formancie zawartości, który już znajduje się w dokumencie.
AddBuildingBlockGalleryContentControl(Range, String)	Dodaje nowy BuildingBlockGalleryContentControl w określonym zakresie w dokumencie.

AddBuildingBlockGalleryContentControl(String)

Dodaje nowy BuildingBlockGalleryContentControl element do bieżącego zaznaczenia w dokumencie.

public:
 Microsoft::Office::Tools::Word::BuildingBlockGalleryContentControl ^ AddBuildingBlockGalleryContentControl(System::String ^ name);

public Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl AddBuildingBlockGalleryContentControl (string name);

abstract member AddBuildingBlockGalleryContentControl : string -> Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl

Public Function AddBuildingBlockGalleryContentControl (name As String) As BuildingBlockGalleryContentControl

Parametry

name: String

Nazwa nowego formantu.

Zwraca

BuildingBlockGalleryContentControl

Element BuildingBlockGalleryContentControl , który został dodany do dokumentu.

Wyjątki

ArgumentNullException

name jest lub null ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie znajduje się już w obiekcie ControlCollection.

Przykłady

Poniższy przykład kodu dodaje nowy BuildingBlockGalleryContentControl element na początku dokumentu. Wyświetla BuildingBlockGalleryContentControl bloki konstrukcyjne równania udostępniane przez Word pakietu Microsoft Office.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj AddBuildingBlockControlAtSelection metodę ThisDocument_Startup z metody .

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

Ta wersja jest przeznaczona dla dodatku na poziomie aplikacji, który jest przeznaczony dla .NET Framework 4 lub .NET Framework 4.5. Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie i wywołaj AddBuildingBlockControlAtSelection metodę ThisAddIn_Startup z metody .

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

Uwagi

Użyj tej metody, aby dodać nowy BuildingBlockGalleryContentControl element w bieżącym zaznaczeniu w dokumencie w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Dodawanie kontrolek do dokumentów pakietu Office w czasie wykonywania.

Dotyczy

AddBuildingBlockGalleryContentControl(ContentControl, String)

Dodaje nowy BuildingBlockGalleryContentControl element do kolekcji. Nowy formant opiera się na macierzystym formancie zawartości, który już znajduje się w dokumencie.

public:
 Microsoft::Office::Tools::Word::BuildingBlockGalleryContentControl ^ AddBuildingBlockGalleryContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);

public Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl AddBuildingBlockGalleryContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);

abstract member AddBuildingBlockGalleryContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl

Public Function AddBuildingBlockGalleryContentControl (contentControl As ContentControl, name As String) As BuildingBlockGalleryContentControl

Parametry

contentControl: ContentControl

Jest ContentControl to podstawa nowej kontrolki.

name: String

Nazwa nowego formantu.

Zwraca

BuildingBlockGalleryContentControl

Element BuildingBlockGalleryContentControl , który został dodany do dokumentu.

Wyjątki

ArgumentNullException

contentControl jest null.-or- name lub null ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie znajduje się już w obiekcie ControlCollection.

ArgumentException

contentControlnie jest galerią bloków contentControl konstrukcyjnych (czyli Type właściwość nie ma wartości Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlBuildingBlockGallery).

Przykłady

Poniższy przykład kodu tworzy nowy BuildingBlockGalleryContentControl dla każdej natywnej galerii bloków konstrukcyjnych, która znajduje się już w dokumencie.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj CreateBuildingBlockControlsFromNativeControls metodę ThisDocument_Startup z metody .

private System.Collections.Generic.List
   <Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl> buildingBlockControls;

private void CreateBuildingBlockControlsFromNativeControls()
{
    if (this.ContentControls.Count <= 0)
        return;

    buildingBlockControls = new System.Collections.Generic.List
        <Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl>();
    int count = 0;

    foreach (Word.ContentControl nativeControl in this.ContentControls)
    {
        if (nativeControl.Type == Word.WdContentControlType.wdContentControlBuildingBlockGallery)
        {
            count++;
            Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl tempControl =
                this.Controls.AddBuildingBlockGalleryContentControl(nativeControl,
                "VSTOBuildingBlockContentControl" + count.ToString());
            buildingBlockControls.Add(tempControl);
        }
    }
}

Private buildingBlockControls As New System.Collections.Generic.List _
        (Of Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl)

Private Sub CreateBuildingBlockGalleryControlsFromNativeControls()
    If Me.ContentControls.Count <= 0 Then
        Return
    End If

    Dim count As Integer = 0
    For Each nativeControl As Word.ContentControl In Me.ContentControls
        If nativeControl.Type = Word.WdContentControlType.wdContentControlBuildingBlockGallery Then
            count += 1
            Dim tempControl As Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl = _
                Me.Controls.AddBuildingBlockGalleryContentControl(nativeControl, _
                "VSTOBuildingBlockGalleryContentControl" + count.ToString())
            buildingBlockControls.Add(tempControl)
        End If
    Next nativeControl
End Sub

Ta wersja jest przeznaczona dla dodatku na poziomie aplikacji, który jest przeznaczony dla .NET Framework 4 lub .NET Framework 4.5. Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie dodatku i wywołaj metodę CreateBuildingBlockControlsFromNativeControlsThisAddIn_Startup z metody .

private System.Collections.Generic.List
   <Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl> buildingBlockControls;

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

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    if (vstoDoc.ContentControls.Count <= 0)
    {
        System.Windows.Forms.MessageBox.Show("No content controls found in document.");                    
        return;
    }

    buildingBlockControls = new System.Collections.Generic.List
        <Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl>();
    int count = 0;

    foreach (Word.ContentControl nativeControl in vstoDoc.ContentControls)
    {
        if (nativeControl.Type == Word.WdContentControlType.wdContentControlBuildingBlockGallery)
        {
            count++;
            Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl tempControl =
                vstoDoc.Controls.AddBuildingBlockGalleryContentControl(nativeControl,
                "VSTOBuildingBlockContentControl" + count.ToString());
            buildingBlockControls.Add(tempControl);
        }
    }
}

Private buildingBlockControls As New System.Collections.Generic.List _
        (Of BuildingBlockGalleryContentControl)

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

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    If vstoDoc.ContentControls.Count <= 0 Then
        Return
    End If

    Dim count As Integer = 0
    For Each nativeControl As Word.ContentControl In vstoDoc.ContentControls
        If nativeControl.Type = Word.WdContentControlType.wdContentControlBuildingBlockGallery Then
            count += 1
            Dim tempControl As Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl = _
                vstoDoc.Controls.AddBuildingBlockGalleryContentControl(nativeControl, _
                "VSTOBuildingBlockGalleryContentControl" + count.ToString())
            buildingBlockControls.Add(tempControl)
        End If
    Next nativeControl
End Sub

Poniższy przykład kodu tworzy nowy BuildingBlockGalleryContentControl dla każdej natywnej galerii bloków konstrukcyjnych dodaną przez użytkownika do dokumentu.

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie. W przypadku języka C#należy również dołączyć ThisDocument_BuildingBlockContentControlAfterAdd program obsługi zdarzeń do ContentControlAfterAdd zdarzenia ThisDocument klasy.

void ThisDocument_BuildingBlockContentControlAfterAdd(Word.ContentControl NewContentControl, bool InUndoRedo)
{
    if (NewContentControl.Type == Word.WdContentControlType.wdContentControlBuildingBlockGallery)
    {
        this.Controls.AddBuildingBlockGalleryContentControl(NewContentControl,
            "BuildingBlockControl" + NewContentControl.ID);
    }
}

Private Sub ThisDocument_BuildingBlockContentControlAfterAdd(ByVal NewContentControl As Word.ContentControl, _
    ByVal InUndoRedo As Boolean) Handles Me.ContentControlAfterAdd

    If NewContentControl.Type = Word.WdContentControlType.wdContentControlBuildingBlockGallery Then
        Me.Controls.AddBuildingBlockGalleryContentControl(NewContentControl, _
            "BuildingBlockControl" + NewContentControl.ID)
    End If
End Sub

Ta wersja jest przeznaczona dla dodatku na poziomie aplikacji, który jest przeznaczony dla .NET Framework 4 lub .NET Framework 4.5. Aby użyć tego kodu, wklej go do ThisAddIn klasy w projekcie. Ponadto należy dołączyć procedurę ActiveDocument_BuildingBlockContentControlAfterAdd obsługi zdarzeń do ContentControlAfterAdd zdarzenia aktywnego dokumentu.

void ActiveDocument_BuildingBlockContentControlAfterAdd(
    Word.ContentControl NewContentControl, bool InUndoRedo)
{
    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    if (NewContentControl.Type == Word.WdContentControlType.wdContentControlBuildingBlockGallery)
    {
        vstoDoc.Controls.AddBuildingBlockGalleryContentControl(NewContentControl,
            "BuildingBlockControl" + NewContentControl.ID);
    }
}

Private Sub ActiveDocument_BuildingBlockContentControlAfterAdd( _
    ByVal NewContentControl As Word.ContentControl, _
    ByVal InUndoRedo As Boolean)

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    If NewContentControl.Type = Word.WdContentControlType. _
        wdContentControlBuildingBlockGallery Then
        vstoDoc.Controls.AddBuildingBlockGalleryContentControl(NewContentControl, _
            "BuildingBlockControl" + NewContentControl.ID)
    End If
End Sub

Uwagi

Użyj tej metody, aby dodać nową BuildingBlockGalleryContentControl , która jest oparta na natywnej kontrolce zawartości w dokumencie. Jest to przydatne podczas tworzenia BuildingBlockGalleryContentControl w czasie wykonywania i chcesz ponownie utworzyć tę samą kontrolkę przy następnym otwarciu dokumentu. Aby uzyskać więcej informacji, zobacz Dodawanie kontrolek do dokumentów pakietu Office w czasie wykonywania.

Dotyczy

AddBuildingBlockGalleryContentControl(Range, String)

Dodaje nowy BuildingBlockGalleryContentControl w określonym zakresie w dokumencie.

public:
 Microsoft::Office::Tools::Word::BuildingBlockGalleryContentControl ^ AddBuildingBlockGalleryContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name);

public Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl AddBuildingBlockGalleryContentControl (Microsoft.Office.Interop.Word.Range range, string name);

abstract member AddBuildingBlockGalleryContentControl : Microsoft.Office.Interop.Word.Range * string -> Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl

Public Function AddBuildingBlockGalleryContentControl (range As Range, name As String) As BuildingBlockGalleryContentControl

Parametry

range: Range

Element Range , który zapewnia granice dla nowej kontrolki.

name: String

Nazwa nowego formantu.

Zwraca

BuildingBlockGalleryContentControl

Element BuildingBlockGalleryContentControl , który został dodany do dokumentu.

Wyjątki

ArgumentNullException

name jest lub null ma zerową długość.

ControlNameAlreadyExistsException

Kontrolka o tej samej nazwie znajduje się już w obiekcie ControlCollection.

Przykłady

Ta wersja dotyczy dostosowywania na poziomie dokumentu. Aby użyć tego kodu, wklej go do ThisDocument klasy w projekcie i wywołaj AddBuildingBlockControlAtRange metodę ThisDocument_Startup z metody .

private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl2;

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

    buildingBlockControl2 = this.Controls.AddBuildingBlockGalleryContentControl(
       this.Paragraphs[1].Range, "buildingBlockControl2");
    buildingBlockControl2.PlaceholderText = "Choose an equation";
    buildingBlockControl2.BuildingBlockCategory = "Built-In";
    buildingBlockControl2.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}

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

Private Sub AddBuildingBlockGalleryControlAtRange()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    buildingBlockGalleryControl2 = Me.Controls.AddBuildingBlockGalleryContentControl( _
        Me.Paragraphs(1).Range, "buildingBlockGalleryControl2")
    With buildingBlockGalleryControl2
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub

private Microsoft.Office.Tools.Word.BuildingBlockGalleryContentControl buildingBlockControl2;

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

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

    buildingBlockControl2 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl(
       vstoDoc.Paragraphs[1].Range, "buildingBlockControl2");
    buildingBlockControl2.PlaceholderText = "Choose an equation";
    buildingBlockControl2.BuildingBlockCategory = "Built-In";
    buildingBlockControl2.BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations;
}

Dim buildingBlockGalleryControl2 As BuildingBlockGalleryContentControl

Private Sub AddBuildingBlockGalleryControlAtRange()
    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()
    buildingBlockGalleryControl2 = vstoDoc.Controls.AddBuildingBlockGalleryContentControl( _
        vstoDoc.Paragraphs(1).Range, "buildingBlockGalleryControl2")
    With buildingBlockGalleryControl2
        .PlaceholderText = "Choose an equation"
        .BuildingBlockCategory = "Built-In"
        .BuildingBlockType = Word.WdBuildingBlockTypes.wdTypeEquations
    End With
End Sub

Uwagi

Użyj tej metody, aby dodać nowy BuildingBlockGalleryContentControl w określonym zakresie w dokumencie w czasie wykonywania. Aby uzyskać więcej informacji, zobacz Dodawanie kontrolek do dokumentów pakietu Office w czasie wykonywania.

Dotyczy

Udostępnij za pośrednictwem

ControlCollection.AddBuildingBlockGalleryContentControl Metoda

Definicja

Przeciążenia

AddBuildingBlockGalleryContentControl(String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

AddBuildingBlockGalleryContentControl(ContentControl, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

AddBuildingBlockGalleryContentControl(Range, String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

Dodatkowe zasoby