Edit

Range.PasteSpecial method (Word)

  • Article

Inserts the contents of the Clipboard. .

Syntax

expression.PasteSpecial (IconIndex, Link, Placement, DisplayAsIcon, DataType, IconFileName, IconLabel)

expression Required. A variable that represents a Range object.

Parameters

Name Required/Optional Data type Description
IconIndex Optional Variant If DisplayAsIcon is True, this argument is a number that corresponds to the icon you want to use in the program file specified by IconFilename. Icons appear in the Change Icon dialog box: 0 (zero) corresponds to the first icon, 1 corresponds to the second icon, and so on. If this argument is omitted, the first (default) icon is used.
Link Optional Variant True to create a link to the source file of the Clipboard contents. The default value is False.
Placement Optional Variant Can be either of the following WdOLEPlacement constants: wdFloatOverText or wdInLine. The default value is wdInLine.
DisplayAsIcon Optional Variant True to display the link as an icon. The default value is False.
DataType Optional Variant A format for the Clipboard contents when they're inserted into the document. Can be any WdPasteDataType constant.
IconFileName Optional Variant If DisplayAsIcon is True, this argument is the path and file name for the file in which the icon to be displayed is stored.
IconLabel Optional Variant If DisplayAsIcon is True, this argument is the text that appears below the icon.

Example

This example inserts the Clipboard contents at the insertion point as unformatted text.

Selection.Collapse Direction:=wdCollapseStart 
Selection.Range.PasteSpecial DataType:=wdPasteText

This example copies the selected text and pastes it into a new document as a hyperlink. The source document must first be saved for this example to work.

If Selection.Type = wdSelectionNormal Then 
 Selection.Copy 
 Documents.Add.Content.PasteSpecial Link:=True, _ 
 DataType:=wdPasteHyperlink 
End If

See also

Range Object

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.