PictureContentControl 接口

项目
05/20/2013

表示显示图像的文档区域。

命名空间： 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 Word 当前实例的 Microsoft.Office.Interop.Word.Application。
	BindingContext	获取或设置 IBindableComponent 的货币管理器的集合。（继承自 IBindableComponent。）
	Container	基础结构。（继承自 ContentControlBase。）
	ContainerComponent	基础结构。（继承自 ContentControlBase。）
	Creator	获取一个 32 位整数，该整数指示已在其中创建 PictureContentControl 的应用程序。
	DataBindings	获取此 IBindableComponent 的数据绑定对象的集合。（继承自 IBindableComponent。）
	DefaultDataSourceUpdateMode	获取或设置 ContentControlBase 的默认 DataSourceUpdateMode。（继承自 ContentControlBase。）
	ID	获取标识内容控件的唯一编号。（继承自 ContentControlBase。）
	Image	获取或设置由 PictureContentControl 显示的图像。
	InnerObject	获取 Microsoft.Office.Tools.Word.ContentControlBase 的基础 Microsoft.Office.Interop.Word.ContentControl 对象。（继承自 ContentControlBase。）
	LockContentControl	获取或设置一个值，该值指定是否可从文档中删除 PictureContentControl。
	LockContents	获取或设置一个值，该值指定 PictureContentControl 的内容是否可以编辑。
	Parent	获取 PictureContentControl 的父级。
	ParentContentControl	获取嵌套在另一个内容控件内的 PictureContentControl 的父内容控件。
	Range	获取一个表示 PictureContentControl 的内容的 Range。
	ShowInsertPictureIcon	获取或设置一个值，该值指定是否显示 UI，用户可以在运行时单击此 UI，以便选择要在控件中显示的图像。
	Site	获取或设置与 IComponent 关联的 ISite。（继承自 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	当 ContentControlBase 的 BindingContext 属性的值更改时发生。（继承自 ContentControlBase。）
	ContentUpdating	如果内容控件绑定到自定义 XML 部件，则此事件在 Microsoft Office Word 更新内容控件中的文本之前发生。（继承自 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 Runtime 实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

内容控件

可用在 Microsoft Office Word 中设计文档和模板的内容控件有八种，PictureContentControl 是其中之一。内容控件具有一个用户界面 (UI)，其中包含类似于窗体的受控输入。使用内容控件可以防止用户编辑文档或模板的受保护部分，还可以将内容控件绑定到数据源。有关更多信息，请参见内容控件。

用法

本文档介绍面向 .NET Framework 4 和 .NET Framework 4.5 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关面向 .NET Framework 3.5 的项目中的此类型的文档，请参见 Visual Studio 2008 文档中的以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。

示例

下面的代码示例会在文档开头添加一个新的 PictureContentControl。此示例假设 %UserProfile%\My Documents 文件夹（对于 Windows XP 及更低版本）或 %UserProfile%\Documents 文件夹（对于 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;
}