BuildingBlockGalleryContentControl.BuildingBlockType, propriété

Article
05/16/2013

Obtient ou définit le type des blocs de construction affichés dans le BuildingBlockGalleryContentControl.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Property BuildingBlockType As WdBuildingBlockTypes

WdBuildingBlockTypes BuildingBlockType { get; set; }

Valeur de propriété

Type : Microsoft.Office.Interop.Word.WdBuildingBlockTypes
Une des valeurs de Microsoft.Office.Interop.Word.WdBuildingBlockTypes.

Exceptions

Exception	Condition
COMException	La propriété a la valeur Microsoft.Office.Interop.Word.WdBuildingBlockTypes, laquelle identifie une catégorie de blocs de construction qui ne peuvent pas être affichés dans un BuildingBlockGalleryContentControl.

Notes

Tous les blocs de construction appartiennent à une galerie et à une catégorie.Utilisez la propriété BuildingBlockType pour définir la galerie de blocs de construction à afficher dans le BuildingBlockGalleryContentControl.

Un BuildingBlockGalleryContentControl peut afficher uniquement certaines galeries de blocs de construction.La propriété BuildingBlockType ne peut avoir que les valeurs Microsoft.Office.Interop.Word.WdBuildingBlockTypes suivantes :

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

Pour définir la catégorie des blocs de construction affichés par BuildingBlockGalleryContentControl, utilisez la propriété BuildingBlockCategory.

Exemples

L'exemple de code suivant ajoute un nouveau BuildingBlockGalleryContentControl au début du document.BuildingBlockGalleryContentControl affiche des blocs de construction d'équation fournis par Microsoft Office Word.L'exemple affecte la valeur wdTypeEquations à la propriété BuildingBlockType.

Cette version est destinée à une personnalisation au niveau du document.Pour utiliser ce code, collez-le dans la classe ThisDocument de votre projet, puis appelez la méthode AddBuildingBlockControlAtSelection à partir de la méthode 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;
}

Cette version est destinée à un complément d'application.Pour utiliser ce code, collez-le dans la classe ThisAddIn de votre projet, puis appelez la méthode AddBuildingBlockControlAtSelection à partir de la méthode 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;
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

BuildingBlockGalleryContentControl Interface

Microsoft.Office.Tools.Word, espace de noms

Partager via