Método Selection.PasteSpecial (Word)

  • Artigo

Insere o conteúdo da área de transferência.

Sintaxe

expressão. PasteSpecial (IconIndex, Link, Placement, DisplayAsIcon, DataType, IconFileName, IconLabel)

expressão Obrigatório. Uma variável que representa um objeto Selection.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
IconIndex Opcional Variant Se DisplayAsIcon for True, esse argumento será um número que corresponde ao ícone que você deseja usar no arquivo de programa especificado por IconFilename. Se esse argumento for omitido, este método usa o primeiro ícone (padrão).
Link Opcional Variant True para criar um link para o arquivo de origem do conteúdo da área de transferência. O valor padrão é False.
Placement Opcional Variant Pode ser uma das constantes WdOLEPlacement.
DisplayAsIcon Opcional Variant True para exibir o link como um ícone. O valor padrão é False.
DataType Opcional Variant Um formato para o conteúdo da Área de Transferência quando este é inserido no documento. WdPasteDataType.
IconFileName Opcional Variant Se DisplayAsIcon for True, esse argumento será o caminho e o nome do arquivo no qual o ícone a ser exibido está armazenado.
IconLabel Opcional Variant Se DisplayAsIcon for True, esse argumento será o texto que aparece abaixo do ícone.

Comentários

Ao contrário com o método Paste, com PasteSpecial pode controlar o formato das informações coladas e (opcionalmente) estabelecer um vínculo com o arquivo de origem (por exemplo, uma planilha do Microsoft Excel). Se você não quiser substituir o conteúdo da seleção especificada, use o método Collapse antes de usar esse método. Quando você usa esse método, a seleção não é expandida para incluir o conteúdo da área de transferência.

Exemplo

Este exemplo insere o conteúdo da área de transferência no ponto de inserção como texto não formatado.

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

Confira também

Objeto Selection

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.