Método Worksheet.PasteSpecial (Excel)

Cola o conteúdo da Área de Transferência na planilha, usando um formato especificado. Use este método para colar dados de outros aplicativos ou para colar dados em um formato específico.

Sintaxe

expressão. PasteSpecial (Formato, Ligação, DisplayAsIcon, IconFileName, IconIndex, IconLabel, NoHTMLFormatting)

expressão Uma variável que representa um objeto de Folha de Cálculo .

Parâmetros

Nome	Obrigatório/Opcional	Tipo de dados	Descrição
Format	Opcional	Variant	Uma sequência de caracteres que especifica o formato dos dados da Área de Transferência
Link	Opcional	Variant	True para estabelecer um vínculo com a fonte dos dados colados. Se os dados de origem não forem adequados para a ligação ou se a aplicação de origem não suportar a ligação, este parâmetro será ignorado. O valor padrão é False.
DisplayAsIcon	Opcional	Variant	Verdadeiro para apresentar os dados colados como um ícone. O valor padrão é False.
IconFileName	Opcional	Variant	O nome do arquivo que contém o ícone a ser usado se DisplayAsIcon for True.
IconIndex	Opcional	Variant	O número de índice do ícone no arquivo de ícones.
IconLabel	Opcional	Variant	O rótulo de texto do ícone.
NoHTMLFormatting	Opcional	Variant	True para remover a formatação, os hiperlinks e as imagens do HTML. False para colar o HTML como está. O valor padrão é False.

Comentários

Observação

NoHTMLFormatting só é importante quando Format = "HTML"; em todos os outros casos, NoHTMLFormatting é ignorado.

Você precisa selecionar o intervalo de destino antes de usar esse método.

Esse método pode modificar a seleção da planilha, dependendo do conteúdo da Área de Transferência.

Para programadores de idiomas que não o inglês, pode substituir uma das seguintes constantes (0-5) para corresponder ao equivalente de cadeia do formato de ficheiro de imagem.

Formatar argumento	Equivalente de cadeia
0	"Imagem (PNG)"
1	"Imagem (JPEG)"
2	"Imagem (GIF)"
3	"Imagem (Metaficheiro Avançado)"
4	"Mapa de Bits"
5	"Objeto de Desenho do Microsoft Office"

Exemplo

Este exemplo cola um objeto de documento do Microsoft Word da Área de Transferência para a célula D1 de Sheet1.

Worksheets("Sheet1").Range("D1").Select 
ActiveSheet.PasteSpecial format:= _ 
 "Microsoft Word 8.0 Document Object"

Este exemplo cola um objeto de imagem e não o apresenta como um ícone.

Worksheets("Sheet1").Range("F5").PasteSpecial _ 
 Format:="Picture (Enhanced Metafile)", Link:=False,
 DisplayAsIcon:=False 

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.