WorksheetBase.PasteSpecial Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Excel

Ensamblado:: Microsoft.Office.Tools.Excel.v4.0.Utilities.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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.

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

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: 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: Object

true para mostrar el objeto pegado como un icono. El valor predeterminado es false.

iconFileName: Object

Nombre del archivo que contiene el icono que se va a usar si DisplayAsIcon es true.

iconIndex: Object

El número de índice del icono dentro del archivo de iconos.

iconLabel: Object

La etiqueta de texto del icono.

noHTMLFormatting: 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.

Ejemplos

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

Este ejemplo es para una personalización de nivel 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

Comentarios

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

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

Debe seleccionar el intervalo de destino antes de usar este método.

Este método puede modificar la selección de la hoja, según el contenido del Portapapeles.

Parámetros opcionales

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

Se aplica a

Compartir a través de