Proprietà BuildingBlockGalleryContentControl.BuildingBlockType (System 2007)

Aggiornamento: Luglio 2008

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

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

Sintassi

Public Property BuildingBlockType As WdBuildingBlockTypes

Dim instance As BuildingBlockGalleryContentControl
Dim value As WdBuildingBlockTypes

value = instance.BuildingBlockType

instance.BuildingBlockType = value

public 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 = Me.Application.ActiveDocument.GetVstoObject()
    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 = this.Application.ActiveDocument.GetVstoObject();
    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;
}

Autorizzazioni

• 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 Classe

Membri BuildingBlockGalleryContentControl

Spazio dei nomi Microsoft.Office.Tools.Word

Cronologia delle modifiche

Date	History	Motivo
Luglio 2008	Aggiunta una versione dell'esempio di codice per un componente aggiuntivo a livello di applicazione.	Modifica di funzionalità in SP1.