Compartilhar via

Método WorksheetBase.PasteSpecial

  • Artigo

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.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Sub PasteSpecial ( _
    format As Object, _
    link As Object, _
    displayAsIcon As Object, _
    iconFileName As Object, _
    iconIndex As Object, _
    iconLabel As Object, _
    noHTMLFormatting As Object _
)

public void PasteSpecial(
    Object format,
    Object link,
    Object displayAsIcon,
    Object iconFileName,
    Object iconIndex,
    Object iconLabel,
    Object noHTMLFormatting
)

Parâmetros

  • format
    Tipo: System.Object
    Uma cadeia de caracteres que especifica o formato da área de transferência de dados.As cadeias de caracteres comuns de formato incluem “HTML”, “bitmap”, “hiperlink”, “texto Unicode,” e “texto”.
  • link
    Tipo: System.Object
    true para estabelecer um link com a fonte dos dados colados.Se os dados de origem não são adequados para vincular ou aplicativo de origem não suporta vincular, este parâmetro é ignorado.O valor padrão é false.
  • displayAsIcon
    Tipo: System.Object
    true para exibir o objeto colado como um ícone.O valor padrão é false.
  • iconFileName
    Tipo: System.Object
    O nome do arquivo que contém o ícone para usar se DisplayAsIcon é true.
  • iconIndex
    Tipo: System.Object
    O número de índice de ícone no arquivo de ícone.
  • noHTMLFormatting
    Tipo: System.Object
    true para remover qualquer formatação, hiperlinks, e imagens HTML; false para colar HTML como está.O valor padrão é false.

Comentários

Se você não souber cadeia de caracteres passar para o parâmetro de formato, você pode exibir as cadeias de caracteres que são compatíveis com os dados na área de transferência tentando o comando da pasta do excel. Copiar os dados à área de transferência, use o comando de Colar Especial Excel, e exibir os formatos listados na caixa de diálogo Colar Especial .

NoHTMLFormatting irá importar somente quando Format = “HTML”. Em todos os outros casos, NoHTMLFormatting será ignorado.

Você deve selecionar o intervalo de destino antes que você use este 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.

Exemplos

O exemplo de código coloca HTML na área de transferência e usa o método de PasteSpecial 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 método de PasteSpecial .

Este exemplo destina-se a uma personalização no nível de documento.

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

private void PasteSpecialText()
{
    Clipboard.SetText("<HTML><BODY><STRONG>Paste Special Text Example" +
        "</STRONG></BODY></HTML>");

    this.Range["A1"].Select();
    this.PasteSpecial(missing, false, false);
}

Segurança do .NET Framework

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel