Propriedade BuildingBlockGalleryContentControl.BuildingBlockType

Artigo
05/21/2013

Obtém ou define o tipo dos blocos de construção que são exibidos em BuildingBlockGalleryContentControl.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
Property BuildingBlockType As WdBuildingBlockTypes

WdBuildingBlockTypes BuildingBlockType { get; set; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Word.WdBuildingBlockTypes
Um dos valores de Microsoft.Office.Interop.Word.WdBuildingBlockTypes .

Exceções

Exceção	Condição
COMException	A propriedade é definida como um valor de Microsoft.Office.Interop.Word.WdBuildingBlockTypes que identifica uma categoria de blocos de construção que não podem ser exibidos em BuildingBlockGalleryContentControl.

Comentários

Todos os blocos de construção pertencem a uma galeria e uma categoria.Use a propriedade de BuildingBlockType para especificar que galeria dos blocos de construção para exibir em BuildingBlockGalleryContentControl.

BuildingBlockGalleryContentControl pode exibir somente determinadas galerias dos blocos de construção.A propriedade de BuildingBlockType pode ser definida somente aos seguintes valores de Microsoft.Office.Interop.Word.WdBuildingBlockTypes :

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

Para especificar a categoria de blocos de construção que são exibidos por BuildingBlockGalleryContentControl, use a propriedade de BuildingBlockCategory .

Exemplos

O exemplo de código a seguir adiciona novo BuildingBlockGalleryContentControl para o início do documento.BuildingBlockGalleryContentControl exibe os blocos de construção de equação que são fornecidos pelo Microsoft Office Word.O exemplo define a propriedade de BuildingBlockType a wdTypeEquations.

Esta é uma versão para personalização da nível.Para usar este código, cole na classe de ThisDocument em seu projeto, e chame o método de AddBuildingBlockControlAtSelection do método de 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;
}

Esta versão é para um suplemento ao aplicativo.Para usar este código, cole na classe de ThisAddIn em seu projeto, e chame o método de AddBuildingBlockControlAtSelection do método de 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;
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

BuildingBlockGalleryContentControl Interface

Namespace Microsoft.Office.Tools.Word

Partilhar via