Bookmark.PasteSpecial 方法

定义

命名空间:

Microsoft.Office.Tools.Word

程序集:

Microsoft.Office.Tools.Word.dll

将剪贴板的内容插入 Bookmark 控件。

public void PasteSpecial (ref object IconIndex, ref object Link, ref object Placement, ref object DisplayAsIcon, ref object DataType, ref object IconFileName, ref object IconLabel);

abstract member PasteSpecial : obj * obj * obj * obj * obj * obj * obj -> unit

Public Sub PasteSpecial (Optional ByRef IconIndex As Object, Optional ByRef Link As Object, Optional ByRef Placement As Object, Optional ByRef DisplayAsIcon As Object, Optional ByRef DataType As Object, Optional ByRef IconFileName As Object, Optional ByRef IconLabel As Object)

参数

IconIndex

Object

如果 DisplayAsIcon 为 true，则此参数是一个数字，它对应于要在 指定的 IconFilename程序文件中使用的图标。 图标显示在“更改图标”对话框中：0（零）对应于第一个图标，1 对应于第二个图标，依此类推。 如果省略此参数，则使用第一个（默认）图标。

Link

Object

为 true，则创建一个到剪贴板内容的源文件的链接。 默认值为 false。

Placement

Object

可以为以下 WdOLEPlacement 常数之一：wdFloatOverText 或 wdInLine。 默认值为 wdInLine。

DisplayAsIcon

Object

为 true，则以图标形式显示链接。 默认值为 false。

DataType

Object

在将剪贴板内容插入文档时，剪贴板内容的格式。 WdPasteDataType.

IconFileName

Object

如果 DisplayAsIcon 为 true，则此参数是存储要显示图标的文件的路径和文件名。

IconLabel

Object

如果 DisplayAsIcon 为 true，则此参数是图标下方显示的文本。

示例

下面的代码示例将剪贴板内容作为无格式文本插入控件中 Bookmark 。 此示例假定剪贴板包含一些文本。

此示例适用于文档级自定义项。

private void BookmarkPasteSpecial()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Bookmark bookmark1 =
        this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "bookmark1");
    
    object DataType = Word.WdPasteDataType.wdPasteText;
    bookmark1.PasteSpecial(ref missing, ref missing, ref missing,
        ref missing, ref DataType, ref missing, ref missing);
}

Private Sub BookmarkPasteSpecial()

    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim Bookmark1 As Microsoft.Office.Tools.Word.Bookmark = _
        Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")

    Bookmark1.PasteSpecial(DataType:=Word.WdPasteDataType.wdPasteText)

End Sub

注解

与 Paste 方法不同，使用 PasteSpecial 可以控制粘贴信息的格式， (可以选择) (（例如 Microsoft Office Excel 工作表) ）建立指向源文件的链接。

调用此方法可能会删除控件 Bookmark 。

可选参数

有关可选参数的信息，请参阅 Office 解决方案中的可选参数。