Proprietà BuildingBlockGalleryContentControl.BuildingBlockType

Articolo
08/11/2011

Ottiene o imposta il tipo di blocchi predefiniti visualizzati in BuildingBlockGalleryContentControl.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Property BuildingBlockType As WdBuildingBlockTypes
    Get
    Set

WdBuildingBlockTypes BuildingBlockType { get; set; }

Valore proprietà

Tipo: Microsoft.Office.Interop.Word.WdBuildingBlockTypes
Uno dei valori Microsoft.Office.Interop.Word.WdBuildingBlockTypes.

Eccezioni

Eccezione	Condizione
COMException	La proprietà viene impostata su un valore Microsoft.Office.Interop.Word.WdBuildingBlockTypes che identifica una categoria di blocchi predefiniti non visualizzabili in BuildingBlockGalleryContentControl.

Note

Tutti i blocchi predefiniti appartengono a una categoria e una raccolta. Utilizzare la proprietà BuildingBlockType per specificare la raccolta di blocchi predefiniti da visualizzare in BuildingBlockGalleryContentControl.

In BuildingBlockGalleryContentControl sono visualizzabili soltanto determinate raccolte di blocchi predefiniti. La proprietà BuildingBlockType può essere impostata unicamente su uno dei valori Microsoft.Office.Interop.Word.WdBuildingBlockTypes riportati di seguito:

wdTypeAutoText
wdTypeCustom1
wdTypeCustom2
wdTypeCustom3
wdTypeCustom4
wdTypeCustom5
wdTypeCustomAutoText
wdTypeCustomEquations
wdTypeCustomQuickParts
wdTypeCustomTables
wdTypeEquations
wdTypeQuickParts
wdTypeTables

Utilizzare la proprietà BuildingBlockCategory per specificare la categoria di blocchi predefiniti visualizzati da BuildingBlockGalleryContentControl.

Esempi

Nell'esempio di codice seguente viene aggiunto un nuovo oggetto BuildingBlockGalleryContentControl all'inizio del documento. BuildingBlockGalleryContentControl visualizza i blocchi predefiniti di equazione forniti da Microsoft Office Word. Nell'esempio la proprietà BuildingBlockType viene impostata su wdTypeEquations.

Questa versione è valida per una personalizzazione a livello di documento. Per utilizzare questo codice, incollarlo nella classe ThisDocument del progetto, quindi chiamare il metodo AddBuildingBlockControlAtSelection dal metodo ThisDocument_Startup.

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

Questa versione è valida per un componente aggiuntivo a livello di applicazione. Per utilizzare questo codice, incollarlo nella classe ThisAddIn del progetto, quindi chiamare il metodo AddBuildingBlockControlAtSelection dal metodo ThisAddIn_Startup.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

BuildingBlockGalleryContentControl Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite