WorksheetBase.PasteSpecial Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Excel

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

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)

Paramètres

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

true pour afficher l'objet collé comme une icône. La valeur par défaut est false.

iconFileName: Object

Nom du fichier qui contient l’icône à utiliser si DisplayAsIcon est true.

iconIndex: Object

Le numéro d'index de l'icône dans le fichier icône.

iconLabel: Object

L'étiquette de texte de l'icône.

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

Exemples

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

Cet exemple concerne une personnalisation au niveau du document.

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

Remarques

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

NoHTMLFormatting n’a d’importance que quand Format = « HTML ». Dans tous les autres cas, NoHTMLFormatting sera ignoré.

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

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

Paramètres facultatifs

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

S’applique à

Partager via