WorksheetBase.PasteSpecial(Object, Object, Object, Object, Object, Object, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cola o conteúdo da área de transferência na planilha usando um formato especificado. Use esse método para colar dados de outros aplicativos ou para colar dados em um formato específico.
public void PasteSpecial (object format, object link, object displayAsIcon, object iconFileName, object iconIndex, object iconLabel, object noHTMLFormatting);
Parâmetros
- format
- Object
Uma cadeia de caracteres que especifica o formato da área de transferência dos dados. As cadeias de caracteres de formato comuns incluem "HTML", "Bitmap", "Hiperlink", "Texto Unicode" e "Texto".
- link
- Object
true para estabelecer um link com a fonte dos dados colados. Se os dados de origem não forem adequados para a vinculação ou se o aplicativo de origem não der suporte à vinculação, esse parâmetro será ignorado. O valor padrão é false.
- displayAsIcon
- Object
true para exibir o objeto colado como um ícone. O valor padrão é false.
- iconFileName
- Object
O nome do arquivo que contém o ícone a ser usado se DisplayAsIcon for true.
- iconIndex
- Object
O número de índice do ícone dentro do arquivo de ícone.
- iconLabel
- Object
O rótulo de texto do ícone.
- noHTMLFormatting
- Object
true para remover toda a formatação, hiperlinks e imagens do HTML, false para colar o HTML como está. O valor padrão é false.
Exemplos
O exemplo de código a seguir coloca HTML na área de transferência e, em seguida, usa o PasteSpecial método para colar o conteúdo da área de transferência na célula a1. Observe que o exemplo seleciona o intervalo antes de chamar o PasteSpecial método.
Este exemplo destina-se a uma personalização no nível de documento.
private void PasteSpecialText()
{
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
"</STRONG></BODY></HTML>");
this.Range["A1"].Select();
this.PasteSpecial(missing, false, false);
}
Private Sub PasteSpecialText()
Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" & _
"</STRONG></BODY></HTML>")
Me.Range("A1").Select()
Me.PasteSpecial(Link:=False, DisplayAsIcon:=False)
End Sub
Comentários
Se você não souber qual cadeia de caracteres a ser passada para o parâmetro de formato, poderá exibir as cadeias que são compatíveis com os dados na área de transferência, experimentando o comando colar no Excel. Copie os dados para a área de transferência, use o comando colar especial no Excel e, em seguida, exiba os formatos listados na caixa de diálogo colar especial .
NoHTMLFormattingSó será relevante quando Format = "html". Em todos os outros casos, NoHTMLFormatting será ignorado.
Você deve selecionar o intervalo de destino antes de usar esse método.
Este método pode modificar a seleção da folha, dependendo do conteúdo da Área de Transferência.
Parâmetros opcionais
Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.