PictureContentControl - интерфейс
Представляет область документа, в которой выводится изображение.
Пространство имен: Microsoft.Office.Tools.Word
Сборка: Microsoft.Office.Tools.Word (в Microsoft.Office.Tools.Word.dll)
Синтаксис
'Декларация
<GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")> _
Public Interface PictureContentControl _
Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable, _
ISupportInitialize
[GuidAttribute("51d2a6a8-eb22-448f-b239-2e8a3b86ea3e")]
public interface PictureContentControl : ContentControlBase,
IBindableComponent, IComponent, IDisposable, ISupportInitialize
Тип PictureContentControl предоставляет следующие члены.
Свойства
Имя | Описание | |
---|---|---|
Application | Получает объект Microsoft.Office.Interop.Word.Application, представляющий текущий экземпляр Microsoft Office Word. | |
BindingContext | Возвращает или задает коллекцию диспетчеров валют для IBindableComponent. (Унаследовано от IBindableComponent.) | |
Container | Инфраструктура. (Унаследовано от ContentControlBase.) | |
ContainerComponent | Инфраструктура. (Унаследовано от ContentControlBase.) | |
Creator | Возвращает 32-разрядное целое число, указывающее приложение, в котором был создан элемент управления PictureContentControl. | |
DataBindings | Возвращает коллекцию объектов привязки данных для данного IBindableComponent. (Унаследовано от IBindableComponent.) | |
DefaultDataSourceUpdateMode | Получает или задает значение DataSourceUpdateMode по умолчанию для ContentControlBase. (Унаследовано от ContentControlBase.) | |
ID | Возвращает уникальное число, идентифицирующее элемент управления содержимым. (Унаследовано от ContentControlBase.) | |
Image | Возвращает или задает изображение, отображаемое элементом управления PictureContentControl. | |
InnerObject | Получает базовый объект Microsoft.Office.Interop.Word.ContentControl для объекта Microsoft.Office.Tools.Word.ContentControlBase. (Унаследовано от ContentControlBase.) | |
LockContentControl | Получает или задает значение, указывающее, можно ли удалить из документа объект PictureContentControl. | |
LockContents | Возвращает или задает значение, указывающее, можно ли изменять содержимое элемента управления PictureContentControl. | |
Parent | Возвращает родительский объект для элемента управления PictureContentControl. | |
ParentContentControl | Возвращает родительский элемент управления содержимым для элемента управления PictureContentControl, вложенного в другой элемент управления содержимым. | |
Range | Возвращает объект Range, представляющий содержимое элемента управления PictureContentControl. | |
ShowInsertPictureIcon | Возвращает или задает значение, указывающее, следует ли отображать элемент пользовательского интерфейса, с помощью которого пользователи смогут выбирать изображение, выводимое в элементе управления во время выполнения. | |
Site | Возвращает или задает объект ISite, связанный с объектом IComponent. (Унаследовано от IComponent.) | |
Tag | Возвращает или задает строку, которую необходимо связать с элементом управления PictureContentControl. | |
Temporary | Возвращает или задает значение, указывающее, будет ли элемент управления PictureContentControl автоматически удаляться из документа при изменении этого элемента управления. | |
Title | Получает или задает заголовок PictureContentControl. | |
XMLMapping | Возвращает объект XMLMapping, представляющий связь между элементом управления PictureContentControl и элементом в пользовательской XML-части. |
В начало страницы
Методы
Имя | Описание | |
---|---|---|
BeginInit | Подает сигнал объекту о начале инициализации. (Унаследовано от ISupportInitialize.) | |
Copy | Копирует элемент управления PictureContentControl из документа в буфер обмена. | |
Cut | Удаляет из документа элемент управления PictureContentControl и заносит его в буфер обмена. | |
Delete | Удаляет из документа и коллекции ControlCollection динамически созданный элемент управления содержимым. (Унаследовано от ContentControlBase.) | |
Dispose | Выполняет определяемые приложением задачи, связанные с высвобождением или сбросом неуправляемых ресурсов. (Унаследовано от IDisposable.) | |
EndInit | Подает объекту сигнал о завершении инициализации. (Унаследовано от ISupportInitialize.) |
В начало страницы
События
Имя | Описание | |
---|---|---|
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.) |
В начало страницы
Заметки
Элемент управления PictureContentControl выводит изображение.Изображение можно указать во время разработки или выполнения. Пользователи также могут щелкнуть элемент управления, чтобы выбрать изображение для вставки в документ.
Чтобы получить или задать изображение, воспользуйтесь свойством Image.По умолчанию пользователи не могут изменять изображение в элементе управления PictureContentControl во время выполнения.Если необходимо предоставить пользователям возможность выбирать изображение, выводимое элементом управления, присвойте свойству ShowInsertPictureIcon значение true.
Примечание |
---|
Данный интерфейс реализован набором средств Visual Studio Tools for Office (среда выполнения). Он не предназначен для реализации в пользовательском коде. Дополнительные сведения см. в разделе Общие сведения об инструментах Visual Studio для среды выполнения Office. |
Элементы управления содержимым
Элемент управления PictureContentControl является одним из восьми типов элементов управления содержимым, используемых для разработки документов и шаблонов в приложении 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.
Примеры
В приведенном ниже примере кода в начало документа добавляется новый элемент управления PictureContentControl.В данном примере предполагается, что в папке %UserProfile%\Мои документы (в операционной системе Windows XP и предыдущих версиях Windows) или в папке %UserProfile%\Документы (в операционной системе Windows Vista) имеется файл с именем picture.bmp.
Эта версия предназначена для настройки уровня документа.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisDocument и вызовите из метода ThisDocument_Startup метод AddPictureControlAtSelection.
Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap
Private Sub AddPictureControlAtSelection()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
pictureControl1 = Me.Controls.AddPictureContentControl("pictureControl1")
Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
"\picture.bmp"
bitmap1 = New System.Drawing.Bitmap(imagePath, True)
pictureControl1.Image = bitmap1
End Sub
private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;
private void AddPictureControlAtSelection()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
pictureControl1 = this.Controls.AddPictureContentControl("pictureControl1");
string imagePath = System.Environment.GetFolderPath(
Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
bitmap1 = new System.Drawing.Bitmap(imagePath, true);
pictureControl1.Image = bitmap1;
}
Эта версия предназначена для надстройки уровня приложения.Чтобы воспользоваться этим кодом, вставьте его в проекте в класс ThisAddIn и вызовите из метода ThisAddIn_Startup метод AddPictureControlAtSelection.
Dim pictureControl1 As Microsoft.Office.Tools.Word.PictureContentControl
Dim bitmap1 As System.Drawing.Bitmap
Private Sub AddPictureControlAtSelection()
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()
pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1")
Dim imagePath As String = My.Computer.FileSystem.SpecialDirectories.MyDocuments & _
"\picture.bmp"
bitmap1 = New System.Drawing.Bitmap(imagePath, True)
pictureControl1.Image = bitmap1
End Sub
private Microsoft.Office.Tools.Word.PictureContentControl pictureControl1;
private System.Drawing.Bitmap bitmap1;
private void AddPictureControlAtSelection()
{
if (this.Application.ActiveDocument == null)
return;
Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
vstoDoc.Paragraphs[1].Range.Select();
pictureControl1 = vstoDoc.Controls.AddPictureContentControl("pictureControl1");
string imagePath = System.Environment.GetFolderPath(
Environment.SpecialFolder.MyDocuments) + "\\picture.bmp";
bitmap1 = new System.Drawing.Bitmap(imagePath, true);
pictureControl1.Image = bitmap1;
}
См. также
Ссылки
Microsoft.Office.Tools.Word - пространство имен
Другие ресурсы
Элементы управления содержимым
Практическое руководство. Добавление элементов управления содержимым в документы Word
Практическое руководство. Защита частей документов с помощью элементов управления содержимым
Пошаговое руководство. Создание шаблона с помощью элементов управления содержимым
Пошаговое руководство. Привязка элементов управления содержимым к пользовательским XML-частям