Partager via

WorksheetBase.PasteSpecial, méthode

  • Article

Colle le contenu du Presse-papiers dans la feuille de calcul, à l'aide d'un format spécifié. Utilisez cette méthode pour coller des données d'autres applications ou pour coller des données dans un format spécifique.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Déclaration
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
)

Paramètres

  • format
    Type : System.Object
    Chaîne qui spécifie le format des données dans le Presse-papiers.Les chaînes de format courantes incluent « HTML », « Bitmap », « Lien hypertexte », « Texte Unicode » et « Texte ».
  • link
    Type : System.Object
    true pour établir un lien vers la source des données collées.Si les données sources ne conviennent pas pour les liaisons ou si l'application source ne prend pas en charge les liaisons, ce paramètre est ignoré.La valeur par défaut est false.
  • displayAsIcon
    Type : System.Object
    true pour afficher l'objet collé comme une icône.La valeur par défaut est false.
  • iconFileName
    Type : System.Object
    Nom du fichier qui contient l'icône à utiliser si DisplayAsIcon a la valeur true.
  • iconIndex
    Type : System.Object
    Le numéro d'index de l'icône dans le fichier icône.
  • iconLabel
    Type : System.Object
    L'étiquette de texte de l'icône.
  • noHTMLFormatting
    Type : System.Object
    true pour supprimer les mises en forme, liens hypertexte et images de HTML ; false pour coller le HTML tel quel.La valeur par défaut est false.

Notes

Si vous ne savez pas quelle chaîne passer au paramètre Format, vous pouvez consulter les chaînes compatibles avec les données du Presse-papiers en essayant la commande de collage d'Excel. Copiez les données vers le Presse-papiers, utilisez la commande Collage spécial dans Excel, puis consultez les formats répertoriés dans la boîte de dialogue Collage spécial.

NoHTMLFormatting importe uniquement lorsque Format = "HTML". Dans tous les autres cas, NoHTMLFormatting est ignoré.

Vous devez sélectionner la plage de destination avant d'utiliser cette méthode.

Cette méthode peut, en fonction du contenu du Presse-papiers, modifier la sélection de feuille.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant place le code HTML dans le Presse-papiers, puis utilise la méthode PasteSpecial pour coller le contenu du Presse-papiers dans la cellule A1. Notez que l'exemple sélectionne la plage avant d'appeler la méthode PasteSpecial.

Cet exemple illustre une personnalisation au niveau du document.

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);
}

Sécurité .NET Framework

Voir aussi

Référence

WorksheetBase Classe

Microsoft.Office.Tools.Excel, espace de noms