BuildingBlockGalleryContentControl - интерфейс
Представляет коллекцию стандартных блоков, которые пользователи могут вставлять в документ.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)
Синтаксис
'Декларация
<GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")> _
Public Interface BuildingBlockGalleryContentControl _
Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable, _
ISupportInitialize
[GuidAttribute("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : ContentControlBase,
IBindableComponent, IComponent, IDisposable, ISupportInitialize
Тип BuildingBlockGalleryContentControl предоставляет следующие члены.
Свойства
Имя | Описание | |
---|---|---|
![]() |
Application | Получает объект Microsoft.Office.Interop.Word.Application, представляющий текущий экземпляр Microsoft Office Word. |
![]() |
BindingContext | Возвращает или задает коллекцию диспетчеров валют для IBindableComponent. (Унаследовано от IBindableComponent.) |
![]() |
BuildingBlockCategory | Возвращает или задает категорию стандартных блоков, отображаемых в элементе управления BuildingBlockGalleryContentControl. |
![]() |
BuildingBlockType | Возвращает или задает тип стандартных блоков, отображаемых в элементе управления BuildingBlockGalleryContentControl. |
![]() |
Container | Инфраструктура. (Унаследовано от ContentControlBase.) |
![]() |
ContainerComponent | Инфраструктура. (Унаследовано от ContentControlBase.) |
![]() |
Creator | Получает 32-разрядное целое число, указывающее приложение, в котором был создан объект BuildingBlockGalleryContentControl. |
![]() |
DataBindings | Возвращает коллекцию объектов привязки данных для данного IBindableComponent. (Унаследовано от IBindableComponent.) |
![]() |
DefaultDataSourceUpdateMode | Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase. (Унаследовано от ContentControlBase.) |
![]() |
DefaultTextStyle | Возвращает имя стиля знака, используемого для форматирования текста в элементе управления BuildingBlockGalleryContentControl. |
![]() |
ID | Возвращает уникальное число, идентифицирующее элемент управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
InnerObject | Получает базовый объект Microsoft.Office.Interop.Word.ContentControl для объекта Microsoft.Office.Tools.Word.ContentControlBase. (Унаследовано от ContentControlBase.) |
![]() |
LockContentControl | Возвращает или задает значение, указывающее, можно ли удалить из документа элемент управления BuildingBlockGalleryContentControl. |
![]() |
LockContents | Возвращает или задает значение, указывающее, можно ли изменять содержимое элемента управления BuildingBlockGalleryContentControl. |
![]() |
Parent | Возвращает родительский объект для элемента управления BuildingBlockGalleryContentControl. |
![]() |
ParentContentControl | Возвращает родительский элемент управления содержимым для элемента управления BuildingBlockGalleryContentControl, вложенного в другой элемент управления содержимым. |
![]() |
PlaceholderText | Возвращает или задает текст, отображаемый в элементе управления BuildingBlockGalleryContentControl, пока текст не будет изменен в результате действий пользователя или иной операции. |
![]() |
Range | Получает объект Range, представляющий содержимое объекта BuildingBlockGalleryContentControl. |
![]() |
ShowingPlaceholderText | Возвращает значение, указывающее, отображается ли в настоящее время в элементе управления BuildingBlockGalleryContentControl замещающий текст. |
![]() |
Site | Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.) |
![]() |
Tag | Возвращает или задает строку, которую необходимо связать с элементом управления BuildingBlockGalleryContentControl. |
![]() |
Temporary | Возвращает или задает значение, указывающее, будет ли элемент управления BuildingBlockGalleryContentControl автоматически удаляться из документа при изменении этого элемента управления. |
![]() |
Text | Возвращает или задает текст в элементе управления BuildingBlockGalleryContentControl. |
![]() |
Title | Получает или задает заголовок BuildingBlockGalleryContentControl. |
В начало страницы
Методы
Имя | Описание | |
---|---|---|
![]() |
BeginInit | Подает сигнал объекту о начале инициализации. (Унаследовано от ISupportInitialize.) |
![]() |
Copy | Копирует элемент управления BuildingBlockGalleryContentControl из документа в буфер обмена. |
![]() |
Cut | Удаляет из документа элемент управления BuildingBlockGalleryContentControl и заносит его в буфер обмена. |
![]() |
Delete | Удаляет из документа и коллекции ControlCollection динамически созданный элемент управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
Dispose | Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.) |
![]() |
EndInit | Подает объекту сигнал о завершении инициализации. (Унаследовано от ISupportInitialize.) |
![]() |
SetPlaceholderText | Выводит текст, хранящийся в объекте Microsoft.Office.Interop.Word.BuildingBlock, объекте Range или строке в качестве замещающего текста в элементе управления BuildingBlockGalleryContentControl. |
В начало страницы
События
Имя | Описание | |
---|---|---|
![]() |
Added | Происходит после добавления в документ элемента управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
BindingContextChanged | Происходит при изменении значения свойства BindingContext объекта ContentControlBase. (Унаследовано от ContentControlBase.) |
![]() |
ContentUpdating | Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части. (Унаследовано от ContentControlBase.) |
![]() |
Deleting | Происходит непосредственно перед удалением из документа элемента управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
Disposed | Представляет метод, обрабатывающий событие Disposed компонента. (Унаследовано от IComponent.) |
![]() |
Entering | Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
Exiting | Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
StoreUpdating | Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет в пользовательской XML-части, связанной с элементом управления содержимым (то есть после того, как изменится текст в элементе управления содержимым). (Унаследовано от ContentControlBase.) |
![]() |
Validated | Происходит после успешной проверки элемента управления содержимым. (Унаследовано от ContentControlBase.) |
![]() |
Validating | Происходит при проверке содержимого элемента управления. (Унаследовано от ContentControlBase.) |
В начало страницы
Заметки
Элемент управления BuildingBlockGalleryContentControl выводит список стандартных блоков, которые пользователи могут вставлять в документ.Стандартный блок — это часть содержимого, созданная для многократного использования, например общий титульный лист, отформатированная таблица или заголовок.Чтобы выбрать отображаемые стандартные блоки, воспользуйтесь свойствами BuildingBlockCategory и BuildingBlockType.
Дополнительные сведения о стандартных блоках документа см. в разделе Новые возможности для разработчиков в Word 2007.
![]() |
---|
Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office. |
Элементы управления содержимым
Элемент управления BuildingBlockGalleryContentControl является одним из восьми типов элементов управления содержимым, используемых для разработки документов и шаблонов в приложении Microsoft Office Word.Элементы управления с содержимым обладают пользовательским интерфейсом с управляемым вводом, подобным тому, который используется в формах.С помощью элементов управления содержимым можно запретить пользователям редактировать защищенные разделы документа или шаблона; эти элементы управления также можно привязать к источнику данных.Дополнительные сведения см. в разделе Элементы управления содержимым.
Использование
В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформ .NET Framework 4 и .NET Framework 4.5. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию о данном типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.
Примеры
В следующем примере кода в начало документа добавляется новый элемент управления BuildingBlockGalleryContentControl.Элемент управления BuildingBlockGalleryContentControl выводит стандартные блоки формул, предоставляемые приложением Microsoft Office Word.
Эта версия предназначена для настройки уровня документа.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс 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;
}
См. также
Ссылки
Microsoft.Office.Tools.Word - пространство имен
Другие ресурсы
Элементы управления содержимым
Практическое руководство. Добавление элементов управления содержимым в документы Word
Практическое руководство. Защита частей документов с помощью элементов управления содержимым
Пошаговое руководство. Создание шаблона с помощью элементов управления содержимым