WorksheetBase.PasteSpecial 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
使用指定的格式将剪贴板的内容粘贴到工作表上。 使用此方法可粘贴来自其他应用程序的数据或以特定格式粘贴数据。
public void PasteSpecial (object format, object link, object displayAsIcon, object iconFileName, object iconIndex, object iconLabel, object noHTMLFormatting);
member this.PasteSpecial : obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub PasteSpecial (Optional format As Object, Optional link As Object, Optional displayAsIcon As Object, Optional iconFileName As Object, Optional iconIndex As Object, Optional iconLabel As Object, Optional noHTMLFormatting As Object)
参数
- format
- Object
一个字符串,指定数据的剪贴板格式。 常见格式字符串包括“HTML”、“位图”、“超链接”、“Unicode 文本”和“文本”。
- link
- Object
为 true
可建立指向粘贴数据的源的链接。 如果源数据不适合链接或源应用程序不支持链接,则忽略此参数。 默认值为 false
。
- displayAsIcon
- Object
为 true
可以图标形式显示粘贴的对象。 默认值为 false
。
- iconFileName
- Object
如果 DisplayAsIcon
true
为 ,则为包含要使用的图标的文件的名称。
- iconIndex
- Object
图标文件中该图标的索引号。
- iconLabel
- Object
图标的文本标签。
- noHTMLFormatting
- Object
为 true
可从 HTML 移除所有格式设置、超链接和图像;为 false
可按原样粘贴 HTML。 默认值为 false
。
示例
下面的代码示例将 HTML 置于剪贴板上, PasteSpecial 然后使用 方法将剪贴板的内容粘贴到单元格 A1 中。 请注意,该示例在调用 PasteSpecial 方法之前选择范围。
此示例适用于文档级自定义项。
private void PasteSpecialText()
{
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
"</STRONG></BODY></HTML>");
this.Range["A1"].Select();
this.PasteSpecial(missing, false, false);
}
Private Sub PasteSpecialText()
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" & _
"</STRONG></BODY></HTML>")
Me.Range("A1").Select()
Me.PasteSpecial(Link:=False, DisplayAsIcon:=False)
End Sub
注解
如果不知道要传递给 Format 参数的字符串,可以通过在 Excel 中尝试粘贴命令来查看与剪贴板上数据兼容的字符串。 将数据复制到剪贴板,在 Excel 中使用 “选择性粘贴” 命令,然后查看“ 选择性粘贴 ”对话框中列出的格式。
NoHTMLFormatting
仅当 = “HTML” 时才 Format
重要。 在所有其他情况下, NoHTMLFormatting
将被忽略。
在使用此方法之前,必须选择目标范围。
此方法可能会根据剪贴板的内容修改工作表选择。
可选参数
有关可选参数的信息,请参阅 Office 解决方案中的可选参数。