Compartir a través de

WorksheetBase.PasteSpecial (Método)

  • Artículo

Pega el contenido del Portapapeles en la hoja de cálculo, utilizando un formato especificado.Utilice este método para pegar datos de otras aplicaciones o para pegar los datos con un formato concreto.

Espacio de nombres:  Microsoft.Office.Tools.Excel
Ensamblado:  Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxis

'Declaración
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
    Una cadena que especifica el formato Portapapeles de los datos.Las cadenas de formato comunes incluyen "HTML", "Mapa de bits", "Hipervínculo", "Texto Unicode" y "Texto".
  • link
    Tipo: System.Object
    true para establecer un vínculo al origen de los datos pegados.Si los datos de origen no son adecuados para la vinculación o la aplicación de origen no permite la vinculación, se omite este parámetro.El valor predeterminado es false.
  • displayAsIcon
    Tipo: System.Object
    true para mostrar el objeto pegado como un icono.El valor predeterminado es false.
  • iconFileName
    Tipo: System.Object
    El nombre del archivo que contiene el icono que se va a utilizar si DisplayAsIcon es true.
  • iconIndex
    Tipo: System.Object
    El número de índice del icono dentro del archivo de iconos.
  • noHTMLFormatting
    Tipo: System.Object
    true para quitar todo el formato, hipervínculos e imágenes de HTML; false para pegar HTML tal como está.El valor predeterminado es false.

Comentarios

Si no conoce qué cadena pasar al parámetro Format, puede ver las cadenas que son compatibles con los datos en el Portapapeles probando el comando pegar en Excel.Copie los datos en el Portapapeles, use el comando Pegado especial en Excel y, a continuación, vea los formatos enumerados en el cuadro de diálogo Pegado especial.

NoHTMLFormatting solo afectará cuando Format = "HTML".En todos los demás casos, se omite NoHTMLFormatting.

Debe seleccionar el rango de destino antes de utilizar este método.

Este método podría modificar la selección de la hoja, dependiendo del contenido del Portapapeles.

Parámetros opcionales

Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.

Ejemplos

El ejemplo de código siguiente coloca HTML en el Portapapeles y, a continuación, usa el método PasteSpecial para pegar el contenido del Portapapeles en la celda A1.Observe que el ejemplo selecciona el rango antes de llamar al método PasteSpecial.

Se trata de un ejemplo para una personalización en el nivel del 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);
}

Seguridad de .NET Framework

Vea también

Referencia

WorksheetBase Clase

Microsoft.Office.Tools.Excel (Espacio de nombres)