Bookmark.PasteSpecial 方法
将剪贴板的内容插入 Bookmark 控件。
命名空间: Microsoft.Office.Tools.Word
程序集: Microsoft.Office.Tools.Word(在 Microsoft.Office.Tools.Word.dll 中)
语法
声明
Sub PasteSpecial ( _
ByRef IconIndex As Object, _
ByRef Link As Object, _
ByRef Placement As Object, _
ByRef DisplayAsIcon As Object, _
ByRef DataType As Object, _
ByRef IconFileName As Object, _
ByRef IconLabel As Object _
)
void PasteSpecial(
ref Object IconIndex,
ref Object Link,
ref Object Placement,
ref Object DisplayAsIcon,
ref Object DataType,
ref Object IconFileName,
ref Object IconLabel
)
参数
- IconIndex
类型:System.Object%
如果 DisplayAsIcon 为 true,则此参数为一个数字,该数字对应于您希望在程序文件中使用的由 IconFilename 指定的图标。图标显示在**“更改图标”**对话框中:0(零)对应于第一个图标,1 对应于第二个图标,依此类推。如果省略此参数,则使用第一个(默认)图标。
- Link
类型:System.Object%
为 true,则创建一个到剪贴板内容的源文件的链接。默认值为 false。
- Placement
类型:System.Object%
可以是下列 WdOLEPlacement 常数之一:wdFloatOverText 或 wdInLine。默认值为 wdInLine。
- DisplayAsIcon
类型:System.Object%
为 true,则以图标形式显示链接。默认值为 false。
- DataType
类型:System.Object%
在将剪贴板内容插入文档时,剪贴板内容的格式。WdPasteDataType.
- IconFileName
类型:System.Object%
如果 DisplayAsIcon 为 true,则此参数为存储要显示的图标的文件的路径和文件名。
- IconLabel
类型:System.Object%
如果 DisplayAsIcon 为 true,则此参数为显示在图标下面的文本。
备注
与 Paste 方法不同,使用 PasteSpecial 可以控制粘贴的信息的格式和(可选)建立到源文件(例如,一个 Microsoft Office Excel 工作表)的链接。
调用此方法可能会删除 Bookmark 控件。
可选参数
有关可选参数的信息,请参见Office 解决方案中的可选参数。
示例
下面的代码示例以未格式化文本的形式将剪贴板内容插入 Bookmark 控件。 此示例假定剪贴板包含某些文本。
此示例针对的是文档级自定义项。
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
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);
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。