WPS 基础接口 > 演示 API 参考 > Shapes > 方法 > Shapes.PasteSpecial 方法
以指定格式将该形状添加到形状集合中。如果指定数据类型为文本数据类型,则创建一个具有文本的新文本框。如果粘贴成功,PasteSpecial 方法将返回一个表示所粘贴的形状范围的 ShapeRange 对象。

语法

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

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

参数

名称 必选/可选 数据类型 描述
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 决定是否创建指向剪贴板内容的源文件的链接。如果剪贴板内容不支持链接,则会产生错误。

返回值
ShapeRange

说明

PpPasteDataType 可以是下列 PpPasteDataType 常量之一。
ppPasteBitmap
ppPasteDefault:默认值
ppPasteEnhancedMetafile
ppPasteGIF
ppPasteHTML
ppPasteJPG
ppPasteMetafilePicture
ppPasteOLEObject
ppPastePNG
ppPasteRTF
ppPasteShape
ppPasteText
MsoTriState 可以是下列 MsoTriState 常量之一。
msoCTrue:不应用于此方法。
msoFalse:默认值。不将嵌入的对象(或链接)显示为图标。
msoTriStateMixed:不应用于此方法。
msoTriStateToggle:不应用于此方法。
msoTrue 将嵌入的对象(或链接)显示为图标。

调用 PasteSpecial 方法时,如果剪贴板上没有数据,将会产生错误。

示例

以下示例将一个位图图像以图标形式粘贴到另一窗口中。本示例假设有两个打开的窗口,当前选中的是第一个窗口中的位图图像。

示例代码
function PasteOLEObject() {
    Windows.Item(1).Selection.Copy()
    Windows.Item(2).View.PasteSpecial(ppPasteOLEObject, 
        msoTrue, undefined, undefined, "New Bitmap Image")
}


请参阅