BuildingBlockGalleryContentControl.BuildingBlockType, propriété (System 2007)

Mise à jour : Juillet 2008

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.v9.0 (dans Microsoft.Office.Tools.Word.v9.0.dll)

Syntaxe

Public Property BuildingBlockType As WdBuildingBlockTypes

Dim instance As BuildingBlockGalleryContentControl
Dim value As WdBuildingBlockTypes

value = instance.BuildingBlockType

instance.BuildingBlockType = value

public WdBuildingBlockTypes BuildingBlockType { get; set; }

Valeur de propriété

Type : Microsoft.Office.Interop.Word.WdBuildingBlockTypes

Une des valeurs 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 = 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;
}

Autorisations

• 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, classe

Membres BuildingBlockGalleryContentControl

Microsoft.Office.Tools.Word, espace de noms

Historique des modifications

Date	Historique	Raison
Juillet 2008	Ajout d'une version de l'exemple de code pour un complément d'application.	Modifications de fonctionnalités dans le SP1.