ControlExtensions.AddPictureBox 方法 (ControlCollection, Single, Single, Single, Single, String)

按照指定的大小和位置向文档中添加一个新的 PictureBox 控件。

命名空间：  Microsoft.Office.Tools.Word
程序集：  Microsoft.Office.Tools.Word.v4.0.Utilities（在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中）

语法

声明
<ExtensionAttribute> _
Public Shared Function AddPictureBox ( _
    controls As ControlCollection, _
    left As Single, _
    top As Single, _
    width As Single, _
    height As Single, _
    name As String _
) As PictureBox

public static PictureBox AddPictureBox(
    this ControlCollection controls,
    float left,
    float top,
    float width,
    float height,
    string name
)

参数

• controls
  类型：Microsoft.Office.Tools.Word.ControlCollection
  要添加控件的集合。不需要您自己提供此参数。对 Document.Controls 属性（在应用程序级项目中）或 DocumentBase.Controls 属性（在文档级项目中）返回的集合调用此方法时，将自动提供此参数。

• left
  类型：System.Single
  控件左边缘与文档左边缘之间的距离（以磅为单位）。

• top
  类型：System.Single
  控件上边缘和文档上边缘之间的距离（以磅为单位）。

• width
  类型：System.Single
  控件的宽度（以磅为单位）。

• height
  类型：System.Single
  控件的高度（以磅为单位）。

• name
  类型：System.String
  可用于索引 ControlCollection 实例中控件的名称。

返回值

类型：Microsoft.Office.Tools.Word.Controls.PictureBox
添加到文档的控件。

使用说明

在 Visual Basic 和 C# 中，可以在 ControlCollection 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。有关更多信息，请参见扩展方法 (Visual Basic)或扩展方法（C# 编程指南）。

异常

备注

使用此方法可以将 PictureBox 对象添加到 ControlCollection 的末尾。

若要移除通过编程方式添加的 PictureBox，请使用 Remove 方法。

示例

下面的代码示例向文档开头添加一个 PictureBox 控件，然后添加一个图像。 此示例假定 C 盘根目录下有一个名为 Image.jpg 的文件。 若要使用此示例，请从文档级项目内的 ThisDocument 类中运行此示例。

Private Sub WordAddPictureBox()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim PictureBox1 As Microsoft.Office.Tools.Word.Controls. _
        PictureBox = Me.Controls.AddPictureBox(0, 0, 150, 150, _
        "PictureBox1")
    PictureBox1.Image = System.Drawing.Image.FromFile( _
        "C:\Image.jpg")
End Sub 

private void WordAddPictureBox()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.PictureBox
         pictureBox1 = this.Controls.AddPictureBox(
         0, 0, 150, 150, "pictureBox1");
    pictureBox1.Image = System.Drawing.Image.FromFile(
        "C:\\Image.jpg");
}

.NET Framework 安全性

• 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

请参见

参考

ControlExtensions 类

AddPictureBox 重载

Microsoft.Office.Tools.Word 命名空间