Shapes.PasteSpecial, méthode (PowerPoint)
Cette méthode colle le contenu du Presse-papiers en utilisant un format spécial.
Syntaxe
expression. PasteSpecial (DataType, DisplayAsIcon, IconFileName, IconIndex, IconLabel, Link)
expression Variable qui représente un objet Shapes.
Paramètres
| Nom | Requis/Facultatif | Type de données | Description |
|---|---|---|---|
| Type de données | Facultatif | PpPasteDataType | Format des éléments du Presse-papiers lorsqu'ils sont copiés dans le document. La valeur par défaut varie en fonction du contenu du Presse-papiers. Une erreur se produit si le type de données spécifié dans l'argument DataType n'est pas pris en charge par le Presse-papiers. |
| DisplayAsIcon | Facultatif | MsoTriState | MsoTrue Affiche l'objet incorporé (ou son lien) sous la forme d'une icône. |
| IconFileName | Facultatif | String | Si la valeur de DisplayAsIcon est msoTrue, cet argument est le chemin et le nom du fichier dans lequel l’icône à afficher est stockée. Si DisplayAsIcon a la valeur msoFalse, cet argument est ignoré. |
| IconIndex | Facultatif | Long | Si DisplayAsIcon a la valeur msoTrue, cet argument est un nombre qui correspond à l’icône que vous souhaitez utiliser dans le fichier programme spécifié par IconFilename. Par exemple, 0 (zéro) correspond à la première icône, 1 à la deuxième, etc. Si cet argument est omis, la première icône (celle par défaut) est utilisée. Si DisplayAsIcon a la valeur msoFalse, cet argument est ignoré. Si IconIndex est en dehors de la plage autorisée, l'icône par défaut (index 0) est utilisée. |
| IconLabel | Facultatif | String | Si DisplayAsIcon a la valeur msoTrue, cet argument est le texte qui apparaît sous l’icône. Si cette étiquette est manquante, Microsoft PowerPoint crée une étiquette d’icône en fonction du contenu du Presse-papiers. Si DisplayAsIcon a la valeur msoFalse, cet argument est ignoré. |
| Link | Facultatif | MsoTriState | Détermine s'il faut créer un lien au fichier source du contenu du Presse-papiers. Une erreur se produit si le contenu du Presse-papiers ne prend pas en charge un lien. |
Valeur renvoyée
ShapeRange
Remarques
Ajoute la forme à la collection de formes au format spécifié. Si le type de données spécifié est au format texte, une zone de texte est créée avec le texte. Si l’opération de collage réussit, la méthode PasteSpecial renvoie un objet ShapeRange qui représente la plage de formes collée.
La valeur du paramètre DataType peut être l’une de ces constantes PpPasteDataType :
- ppPasteBitmap
- ppPasteDefault
- ppPasteEnhancedMetafile
- ppPasteHTML
- ppPasteGIF
- ppPasteJPG
- ppPasteMetafilePicture
- ppPastePNG
- ppPasteShape
La valeur du paramètre DisplayAsIcon peut être l’une de ces constantes MsoTriState.
| Constante | Description |
|---|---|
| msoFalse | Valeur par défaut. N'affiche pas l'objet incorporé (ni le lien) sous la forme d'une icône. |
| msoTrue | Affiche l’objet incorporé (ou son lien) sous la forme d’une icône. |
Une erreur se produit si aucune donnée ne se trouve dans le Presse-papiers lorsque la méthode PasteSpecial est appelée.
Si le contenu source n’est pas entièrement téléchargé, cette méthode échoue et une erreur se produit. Pour plus d’informations sur les documents partiels, consultez Utiliser des documents partiels.
Voir aussi
Utiliser des documents partiels
Assistance et commentaires
Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.