Compartilhar via


WorksheetBase.PasteSpecial Método

Definição

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.

Aplica-se a