WorksheetBase.PasteSpecial 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);
member this.PasteSpecial : obj * obj * obj * obj * obj * obj * obj -> unit
Public Sub PasteSpecial (Optional format As Object, Optional link As Object, Optional displayAsIcon As Object, Optional iconFileName As Object, Optional iconIndex As Object, Optional iconLabel As Object, Optional noHTMLFormatting As Object)
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 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 passar para o parâmetro Format, poderá exibir as cadeias de caracteres compatíveis com os dados na Área de Transferência ao tentar colar o comando no Excel. Copie os dados para a Área de Transferência, use o comando Colar Especial no Excel e exiba os formatos listados na caixa de diálogo Colar Especial .
NoHTMLFormatting
só importará 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.