BuildingBlockGalleryContentControl.BuildingBlockType - свойство

Статья
05/19/2013

Возвращает или задает тип стандартных блоков, отображаемых в элементе управления BuildingBlockGalleryContentControl.

Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)

Синтаксис

'Декларация
Property BuildingBlockType As WdBuildingBlockTypes

WdBuildingBlockTypes BuildingBlockType { get; set; }

Значение свойства

Тип: Microsoft.Office.Interop.Word.WdBuildingBlockTypes
Одно из значений Microsoft.Office.Interop.Word.WdBuildingBlockTypes.

Исключения

Исключение	Условие
COMException	Этому свойству присваивается значение Microsoft.Office.Interop.Word.WdBuildingBlockTypes, указывающее категорию стандартных блоков, которые не должны отображаться в элементе управления BuildingBlockGalleryContentControl.

Заметки

Каждый стандартный блок относится к определенной категории и коллекции.Чтобы указать коллекцию, в которой стандартные блоки будут отображаться в элементе управления BuildingBlockGalleryContentControl, воспользуйтесь свойством BuildingBlockType.

В элементе управления BuildingBlockGalleryContentControl можно отображать только определенные коллекции стандартных блоков.Свойству BuildingBlockType можно присвоить одно из следующих значений Microsoft.Office.Interop.Word.WdBuildingBlockTypes:

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

Чтобы указать категорию стандартных блоков, отображаемых в элементе управления BuildingBlockGalleryContentControl, воспользуйтесь свойством BuildingBlockCategory.

Примеры

В следующем примере кода в начало документа добавляется новый элемент управления BuildingBlockGalleryContentControl.Элемент управления BuildingBlockGalleryContentControl выводит стандартные блоки формул, предоставляемые приложением Microsoft Office Word.В примере свойству BuildingBlockType присваивается значение wdTypeEquations.

Эта версия предназначена для настройки уровня документа.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisDocument и вызовите из метода ThisDocument_Startup метод AddBuildingBlockControlAtSelection.

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;
}

Эта версия предназначена для надстройки уровня приложения.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisAddIn и вызовите из метода ThisAddIn_Startup метод AddBuildingBlockControlAtSelection.

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;
}

Безопасность платформы .NET Framework

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

BuildingBlockGalleryContentControl Интерфейс

Microsoft.Office.Tools.Word - пространство имен

Поделиться через