C++ 应用集成 WPS 指南 > 演示 API 参考 > View > 方法 > View.PasteSpecial 方法
使用特定格式粘贴剪贴板内容。尽管使用此方法的语法对“应用于”列表中的所有对象来讲是相同的,但是根据调用 PasteSpecial 方法的对象的不同,操作还是有略微的区别。

语法

表达式 .PasteSpecial( DataType , DisplayAsIcon , IconFileName , IconIndex , IconLabel , Link )

表达式 一个代表 View 对象的变量。

参数

名称 必选/可选 数据类型 描述
DataType 可选 PpPasteDataType 剪贴板内容插入文档时采用的格式。默认值随剪贴板内容的不同而不同。如果剪贴板内容不支持 DataType 参数中的指定数据类型,则会出现错误。
DisplayAsIcon 可选 MsoTriState 如果为 msoTrue 则将嵌入的对象(或链接)显示为图标。
IconFileName 可选 String 如果 DisplayAsIcon 设置为 msoTrue ,则此参数为以下文件的路径和文件名,要显示的图标存储在该文件中。如果 DisplayAsIcon 设置为 msoFalse ,则忽略此参数。
IconIndex 可选 Long 如果 DisplayAsIcon 设置为 msoTrue ,则此参数是一个数字,它对应于要在 IconFilename 指定的程序文件中使用的图标。图标显示在 “更改图标” 对话框中,可通过 “标准” 工具栏( “插入” 菜单, “对象” 命令, “新建” 选项)进行访问:0(零)对应于第一个图标,1 对应于第二个图标,依此类推。如果省略此参数,则使用第一个(默认)图标。如果 DisplayAsIcon 设置为 msoFalse ,则忽略此参数。如果 IconIndex 不在有效范围内,则使用默认图标(索引为 0)。
IconLabel 可选 String 如果 DisplayAsIcon 设置为 msoTrue ,则此参数为出现在图标之下的文本。如果缺少此标签,WPP 将根据剪贴板内容生成一个图标标签。如果 DisplayAsIcon 设置为 msoFalse ,则忽略此参数。
Link 可选 MsoTriState 决定是否创建指向剪贴板内容的源文件的链接。如果剪贴板内容不支持链接,则会产生错误。

说明

调用 PasteSpecial 方法时,如果剪贴板上没有数据,则会出现错误。

对象 行为
Shapes 以指定格式将形状添加到形状集合中。如果指定的数据类型为文本数据类型,则创建一个含有文本的新文本框。如果粘贴成功, PasteSpecial 方法将返回一个 ShapeRange 对象,该对象代表已粘贴的形状范围。
TextRange 以指定格式用剪贴板的内容替换文本范围。此对象的有效数据类型为 ppPasteText ppPasteHTML ppPasteRTF (任何其他格式都会产生错误)。如果粘贴成功,此方法将返回一个 TextRange 对象,该对象代表已粘贴的文本范围。
View 将剪贴板上的当前内容粘贴到 View 对象代表的视图中。 PasteSpecial 方法的有效视图与 Paste 方法的有效视图相同。如果无法将数据类型粘贴到视图中(例如,试图将图片粘贴到幻灯片浏览视图中),则会出现错误。

DataType 可以是下列 PpPasteDataType 常量之一。

ppPasteBitmap
ppPasteDefault 默认值
ppPasteEnhancedMetafile
ppPasteGIF
ppPasteHTML
ppPasteJPG
ppPasteMetafilePicture
ppPasteOLEObject
ppPastePNG
ppPasteRTF
ppPasteShape
ppPasteText

DisplayAsIcon 可以是下列 MsoTriState 常量之一:

msoFalse 默认值。嵌入的对象(或链接)不显示为图标。
msoTrue 将嵌入的对象(或链接)显示为图标。

Link 可以是下列 MsoTriState 常量之一:

msoFalse 默认值。不创建指向剪贴板内容的源文件的链接。
msoTrue 创建指向剪贴板内容的源文件的链接。

 

请参阅