BuildingBlockGalleryContentControl Интерфейс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет коллекцию стандартных блоков документа, которые пользователи могут вставлять в документ.
[System.Runtime.InteropServices.Guid("d8d887a2-69fe-4a86-a8dd-352003dc0e7e")]
public interface BuildingBlockGalleryContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
- Атрибуты
- Реализации
Примеры
В следующем примере кода в начало документа добавляется новый BuildingBlockGalleryContentControl . BuildingBlockGalleryContentControlКомпонент отображает стандартные блоки формул, предоставляемые Microsoft Office Word.
Эта версия предназначена для настройки на уровне документа. Чтобы использовать этот код, вставьте его в ThisDocument класс в проекте и вызовите AddBuildingBlockControlAtSelection метод из ThisDocument_Startup метода.
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;
}
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
Эта версия предназначена для надстройки уровня приложения. Чтобы использовать этот код, вставьте его в ThisAddIn класс в проекте и вызовите AddBuildingBlockControlAtSelection метод из ThisAddIn_Startup метода.
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;
}
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
Комментарии
BuildingBlockGalleryContentControlОтображает список стандартных блоков документа , которые пользователи могут вставлять в документ. Стандартный блок документа — это фрагмент содержимого, который был создан для многократного применения, например, общая титульная страница, отформатированная таблица или заголовок. Чтобы выбрать стандартные блоки, которые необходимо отобразить, используйте BuildingBlockCategory BuildingBlockType Свойства и.
Дополнительные сведения о стандартных блоках документов см. в статье новые возможности для разработчиков в Word 2007.
Примечание
Данный интерфейс реализуется набором средств Visual Studio для Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Visual Studio Tools for Office Runtime Overview.
Элементы управления содержимым
BuildingBlockGalleryContentControl— Это один из восьми типов элементов управления содержимым, которые можно использовать для проектирования документов и шаблонов в Microsoft Office Word. Элементы управления содержимым имеют пользовательский интерфейс, который имеет контролируемые входные данные, такие как форма. Элементы управления содержимым можно использовать, чтобы запретить пользователям изменять защищенные разделы документа или шаблона, а также можно привязывать элементы управления содержимым к источнику данных. Для получения дополнительной информации см. Content Controls.
Использование
В настоящей документации описывается версия этого типа, которая используется в проектах Office, предназначенных для платформы .NET Framework 4 или более поздних ее версий. В проектах, предназначенных для платформы .NET Framework 3.5, этот тип может содержать другие члены, а примеры кода, приведенные для этого типа, могут не работать. Документацию об этом типе в проектах, предназначенных для платформы .NET Framework 3.5, см. в следующем справочном разделе документации Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.
Свойства
| Application |
Получает объект Application, представляющий текущий экземпляр Microsoft Office Word. |
| BuildingBlockCategory |
Возвращает или задает категорию стандартных блоков, отображаемых в элементе управления BuildingBlockGalleryContentControl. |
| BuildingBlockType |
Возвращает или задает тип стандартных блоков, отображаемых в элементе управления BuildingBlockGalleryContentControl. |
| Container | (Унаследовано от ContentControlBase) |
| ContainerComponent | (Унаследовано от ContentControlBase) |
| Creator |
Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления BuildingBlockGalleryContentControl. |
| DefaultDataSourceUpdateMode |
Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase. (Унаследовано от ContentControlBase) |
| DefaultTextStyle |
Возвращает имя стиля знака, используемого для форматирования текста в элементе управления BuildingBlockGalleryContentControl. |
| ID |
Возвращает уникальное число, идентифицирующее элемент управления содержимым. (Унаследовано от ContentControlBase) |
| InnerObject |
Получает базовый объект ContentControl для объекта ContentControlBase. (Унаследовано от ContentControlBase) |
| LockContentControl |
Получает или задает значение, которое указывает, можно ли удалять объект BuildingBlockGalleryContentControl из документа. |
| LockContents |
Получает или задает значение, которое указывает, можно ли редактировать содержимое объекта BuildingBlockGalleryContentControl. |
| Parent |
Возвращает родительский класс класса BuildingBlockGalleryContentControl. |
| ParentContentControl |
Возвращает родительский элемент управления содержимым для элемента управления BuildingBlockGalleryContentControl, вложенного в другой элемент управления содержимым. |
| PlaceholderText |
Возвращает или задает текст, отображаемый в элементе управления BuildingBlockGalleryContentControl, пока текст не будет изменен в результате действий пользователя или иной операции. |
| Range |
Получает объект Range, представляющий содержимое объекта BuildingBlockGalleryContentControl. |
| ShowingPlaceholderText |
Возвращает значение, указывающее, отображается ли в настоящее время в элементе управления BuildingBlockGalleryContentControl замещающий текст. |
| Tag |
Возвращает или задает строку, которую необходимо связать с элементом управления BuildingBlockGalleryContentControl. |
| Temporary |
Возвращает или задает значение, указывающее, будет ли элемент управления BuildingBlockGalleryContentControl автоматически удаляться из документа при изменении этого элемента управления. |
| Text |
Возвращает или задает текст в элементе управления BuildingBlockGalleryContentControl. |
| Title |
Получает или задает заголовок BuildingBlockGalleryContentControl. |
Методы
| Copy() |
Копирует элемент управления BuildingBlockGalleryContentControl из документа в буфер обмена. |
| Cut() |
Удаляет из документа элемент управления BuildingBlockGalleryContentControl и заносит его в буфер обмена. |
| Delete(Boolean) |
Удаляет динамически созданный элемент управления содержимым из документа и из коллекции ControlCollection в документе. (Унаследовано от ContentControlBase) |
| SetPlaceholderText(BuildingBlock, Range, String) |
Выводит текст, хранящийся в объекте BuildingBlock, объекте Range или строке в качестве замещающего текста в элементе управления BuildingBlockGalleryContentControl. |
События
| Added |
Происходит после добавления в документ элемента управления содержимым. (Унаследовано от ContentControlBase) |
| BindingContextChanged |
Происходит при изменении значения свойства BindingContext объекта ContentControlBase. (Унаследовано от ContentControlBase) |
| ContentUpdating |
Происходит непосредственно перед тем, как приложение Microsoft Office Word обновляет текст в элементе управления содержимым, если этот элемент управления привязан к настраиваемой XML-части. (Унаследовано от ContentControlBase) |
| Deleting |
Происходит непосредственно перед удалением из документа элемента управления содержимым. (Унаследовано от ContentControlBase) |
| Entering |
Происходит, когда пользователь щелкает мышью внутри элемента управления содержимым, либо при программном перемещении курсора внутрь элемента управления содержимым. (Унаследовано от ContentControlBase) |
| Exiting |
Происходит, когда пользователь щелкает мышью за пределами элемента управления содержимым, либо при программном перемещении курсора за пределы элемента управления содержимым. (Унаследовано от ContentControlBase) |
| StoreUpdating |
Происходит непосредственно перед тем, как Microsoft Office Word автоматически обновляет данные в пользовательской XML-части, которая привязана к элементу управления содержимым (то есть после изменения текста в элементе управления содержимым). (Унаследовано от ContentControlBase) |
| Validated |
Происходит после успешной проверки элемента управления содержимым. (Унаследовано от ContentControlBase) |
| Validating |
Происходит при проверке содержимого элемента управления. (Унаследовано от ContentControlBase) |