Partilhar via

Método WorksheetBase.PasteSpecial

  • Artigo

Cola o conteúdo da área de transferência para a planilha, usando um formato especificado. Use este método para colar os dados de outros aplicativos ou 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 seqüência de caracteres que especifica o formato de área de transferência dos dados.Seqüências de caracteres de formato comuns incluem "HTML", "Bitmap", "Hiperlink", "Texto Unicode" e "Text".
  • link
    Tipo: System.Object
    true para estabelecer um vínculo com a fonte dos dados colados.Se os dados de origem não não adequados para vinculação ou o aplicativo de origem não oferece suporte à vinculação, 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 a ser usado se DisplayAsIcon é true.
  • iconIndex
    Tipo: System.Object
    O número de índice do ícone dentro do arquivo de ícone.
  • noHTMLFormatting
    Tipo: System.Object
    true Para remover toda a formatação, hiperlinks e imagens HTML; falsePara colar o HTML como está.O valor padrão é false.

Comentários

Se você não souber qual cadeia de caracteres para passar para o parâmetro do formato, você pode exibir as seqüências de caracteres que são compatíveis com os dados na área de transferência experimentando o comando Colar no Excel. Copiar os dados para a área de transferência, use o Colar especial comando no Excel e exibir os formatos listados na Colar especial caixa de diálogo.

NoHTMLFormattingserá apenas questão quando Format = "HTML". Em outros casos, NoHTMLFormatting será ignorado.

Antes de usar esse método, você deve selecionar o intervalo de destino.

Esse método pode modificar a seleção da planilha, dependendo do conteúdo da área de transferência.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir coloca o 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 é para uma personalização em 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", missing].Select();
    this.PasteSpecial(missing, false, false, missing, missing,
        missing, missing);
}

Segurança do .NET Framework

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel