Proprietà BuildingBlockGalleryContentControl.BuildingBlockCategory (System 2007)

Aggiornamento: Luglio 2008

Ottiene o imposta la categoria 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 BuildingBlockCategory As String

Dim instance As BuildingBlockGalleryContentControl
Dim value As String

value = instance.BuildingBlockCategory

instance.BuildingBlockCategory = value

public string BuildingBlockCategory { get; set; }

Valore proprietà

Tipo: System.String

Categoria di blocchi predefiniti visualizzati in BuildingBlockGalleryContentControl.

Note

Tutti i blocchi predefiniti appartengono a una categoria e una raccolta. Utilizzare la proprietà BuildingBlockCategory per specificare la categoria di blocchi predefiniti visualizzati da BuildingBlockGalleryContentControl. È possibile impostare il valore di tale proprietà sulle categorie Built-In o General definite da Microsoft Office Word. In alternativa è possibile specificare una categoria personalizzata.

Utilizzare la proprietà BuildingBlockType per specificare la raccolta di blocchi predefiniti da visualizzare in 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à BuildingBlockCategory viene impostata sulla categoria Built-In.

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.