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

mais simples. PasteSpecial (Format, Link, DisplayAsIcon, IconFileName, IconIndex, IconLabel, NoHTMLFormatting)

expressão Uma variável que representa um objeto Worksheet .

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 vinculação ou o aplicativo de origem não for compatível com a vinculação, esse parâmetro será ignorado. O valor padrão é False.
DisplayAsIcon Opcional Variant True para exibir 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ó importa 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 desenvolvedores de idiomas diferentes do inglês, você pode substituir uma das constantes a seguir (0-5) para corresponder ao equivalente de cadeia de caracteres do formato de arquivo de imagem.

Argumento de formato Equivalente de cadeia de caracteres
0 "Imagem (PNG)"
1 "Imagem (JPEG)"
2 "Imagem (GIF)"
3 "Imagem (metarquivo avançado)"
4 "Bitmap"
5 "Microsoft Office Drawing Object"

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 exibe 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.