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 (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 | Variantes | 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 oferecer suporte à vinculação, esse parâmetro será ignorado. O valor padrão é False. |
| DisplayAsIcon | Opcional | Variantes | True para exibir os dados colados como um ícone. O valor padrão é False. |
| IconFileName | Opcional | Variantes | O nome do arquivo que contém o ícone a ser usado se DisplayAsIcon for True. |
| IconIndex | Opcional | Variantes | O número de índice do ícone no arquivo de ícones. |
| IconLabel | Opcional | Variantes | O rótulo de texto do ícone. |
| NoHTMLFormatting | Opcional | Variantes | 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 com a cadeia de caracteres equivalente ao formato de arquivo de imagem.
| Formatar argumento | Equivalente de cadeia de caracteres |
|---|---|
| 0 | "Imagem (PNG)" |
| 1 | "Imagem (JPEG)" |
| 2 | "Imagem (GIF)" |
| 3 | "Imagem (Metafile aprimorado)" |
| 4 | "Bitmap" |
| 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 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.