Presse-papiers

Le Presse-papiers est un ensemble de fonctions et de messages qui permettent aux applications de transférer des données. Étant donné que toutes les applications ont accès au Presse-papiers, les données peuvent être facilement transférées entre les applications ou au sein d’une application.

Cette vue d’ensemble ne décrit pas comment copier et coller des objets liés ou incorporés. Pour plus d’informations sur ces sujets, consultez la documentation COM (Component Object Model).

Dans cette section

Nom	Description
À propos du Presse-papiers	Décrit le Presse-papiers.
Formats du Presse-papiers	Décrit les formats du Presse-papiers. Une fenêtre peut placer plusieurs objets dans le Presse-papiers, chacun représentant les mêmes informations dans un format différent du Presse-papiers. Les utilisateurs n’ont pas besoin de connaître les formats du Presse-papiers utilisés pour un objet dans le Presse-papiers.
Opérations du Presse-papiers	Décrit les opérations du Presse-papiers. Une fenêtre doit utiliser le Presse-papiers pour couper, copier ou coller des données. Une fenêtre place les données dans le Presse-papiers pour les opérations de coupe et de copie et récupère les données du Presse-papiers pour les opérations de collage.
Format du Presse-papiers HTML	Décrit le format du Presse-papiers HTML.
Utilisation du presse-papiers	Une fenêtre de visionneuse du Presse-papiers affiche le contenu actuel du Presse-papiers et reçoit des messages lorsque le contenu du Presse-papiers change.
Informations de référence sur le Presse-papiers	Contient la référence d’API.

Fonctions du Presse-papiers

Nom	Description
AddClipboardFormatListener	Place la fenêtre donnée dans la liste d’écouteurs au format Presse-papiers géré par le système.
ChangeClipboardChain	Supprime une fenêtre spécifiée de la chaîne de visionneuses du Presse-papiers.
CloseClipboard	Ferme le Presse-papiers.
CountClipboardFormats	Récupère le nombre de différents formats de données actuellement dans le Presse-papiers.
EmptyClipboard	Vide le Presse-papiers et libère les poignées dans les données du Presse-papiers. La fonction affecte ensuite la propriété du Presse-papiers à la fenêtre sur laquelle le Presse-papiers est actuellement ouvert.
EnumClipboardFormats	Énumère les formats de données actuellement disponibles dans le Presse-papiers. Les formats de données du Presse-papiers sont stockés dans une liste triée. Pour effectuer une énumération des formats de données du Presse-papiers, vous effectuez une série d’appels à la fonction EnumClipboardFormats . Pour chaque appel, le paramètre de format spécifie un format de Presse-papiers disponible, et la fonction retourne le format de Presse-papiers disponible suivant.
GetClipboardData	Récupère les données du Presse-papiers dans un format spécifié. Le Presse-papiers doit avoir été ouvert précédemment.
GetClipboardFormatName	Récupère dans le Presse-papiers le nom du format inscrit spécifié. La fonction copie le nom dans la mémoire tampon spécifiée.
GetClipboardOwner	Récupère le handle de fenêtre du propriétaire actuel du Presse-papiers.
GetClipboardSequenceNumber	Récupère le numéro de séquence du Presse-papiers pour la station de fenêtre actuelle.
GetClipboardViewer	Récupère le handle dans la première fenêtre de la chaîne de visionneuse du Presse-papiers.
GetOpenClipboardWindow	Récupère le handle de la fenêtre sur laquelle le Presse-papiers est actuellement ouvert.
GetPriorityClipboardFormat	Récupère le premier format de Presse-papiers disponible dans la liste spécifiée.
GetUpdatedClipboardFormats	Récupère les formats du Presse-papiers actuellement pris en charge.
IsClipboardFormatAvailable	Détermine si le Presse-papiers contient des données au format spécifié.
OpenClipboard	Ouvre le Presse-papiers pour examen et empêche d’autres applications de modifier le contenu du Presse-papiers.
RegisterClipboardFormat	Inscrit un nouveau format de Presse-papiers. Ce format peut ensuite être utilisé comme format de Presse-papiers valide.
RemoveClipboardFormatListener	Supprime la fenêtre donnée de la liste d’écouteurs au format Presse-papiers géré par le système.
SetClipboardData	Place les données dans le Presse-papiers dans un format spécifié. La fenêtre doit être le propriétaire actuel du Presse-papiers, et l’application doit avoir appelé la fonction OpenClipboard . (Quand il répond au message WM_RENDERFORMAT , le propriétaire du Presse-papiers ne doit pas appeler OpenClipboard avant d’appeler SetClipboardData.)
SetClipboardViewer	Ajoute la fenêtre spécifiée à la chaîne de visionneuses du Presse-papiers. Les fenêtres de visionneuse du Presse-papiers reçoivent un message WM_DRAWCLIPBOARD chaque fois que le contenu du Presse-papiers change.

Messages du Presse-papiers

Nom	Description
WM_CLEAR	Envoyé à un contrôle de modification ou à une zone de liste déroulante pour supprimer (effacer) la sélection actuelle, le cas échéant, du contrôle d’édition.
WM_COPY	Envoyé à un contrôle d’édition ou à une zone de liste déroulante pour copier la sélection actuelle dans le Presse-papiers au format CF_TEXT .
WM_CUT	Envoyé à un contrôle de modification ou à une zone de liste déroulante pour supprimer (couper) la sélection actuelle, le cas échéant, dans le contrôle d’édition et copier le texte supprimé dans le Presse-papiers dans CF_TEXT format.
WM_PASTE	Envoyé à un contrôle d’édition ou à une zone de liste déroulante pour copier le contenu actuel du Presse-papiers dans le contrôle d’édition à la position actuelle. Les données sont insérées uniquement si le Presse-papiers contient des données au format CF_TEXT .

Notifications du Presse-papiers

Nom	Description
WM_ASKCBFORMATNAME	Envoyé au propriétaire du Presse-papiers par une fenêtre de visionneuse du Presse-papiers pour demander le nom d’un format de presse-papiers CF_OWNERDISPLAY.
WM_CHANGECBCHAIN	Envoyé à la première fenêtre de la chaîne de visionneuse du Presse-papiers lorsqu’une fenêtre est supprimée de la chaîne.
WM_CLIPBOARDUPDATE	Envoyé lorsque le contenu du Presse-papiers a changé.
WM_DESTROYCLIPBOARD	Envoyé au propriétaire du Presse-papiers lorsqu’un appel à la fonction EmptyClipboard vide le Presse-papiers.
WM_DRAWCLIPBOARD	Envoyé à la première fenêtre de la chaîne de visionneuse du Presse-papiers lorsque le contenu du Presse-papiers change. Cela permet à une fenêtre de visionneuse du Presse-papiers d’afficher le nouveau contenu du Presse-papiers.
WM_HSCROLLCLIPBOARD	Envoyé au propriétaire du Presse-papiers par une fenêtre de visionneuse du Presse-papiers. Cela se produit lorsque le Presse-papiers contient des données au format CF_OWNERDISPLAY et qu’un événement se produit dans la barre de défilement horizontale de la visionneuse du Presse-papiers. Le propriétaire doit faire défiler l’image du Presse-papiers et mettre à jour les valeurs de la barre de défilement.
WM_PAINTCLIPBOARD	Envoyé au propriétaire du Presse-papiers par une fenêtre de visionneuse du Presse-papiers lorsque le Presse-papiers contient des données au format CF_OWNERDISPLAY et que la zone cliente du Presse-papiers doit être repeinte.
WM_RENDERALLFORMATS	Envoyé au propriétaire du Presse-papiers avant sa destruction, si le propriétaire du Presse-papiers a retardé le rendu d’un ou de plusieurs formats de Presse-papiers. Pour que le contenu du Presse-papiers reste disponible pour d’autres applications, le propriétaire du Presse-papiers doit afficher les données dans tous les formats qu’il est capable de générer et placer les données dans le Presse-papiers en appelant la fonction SetClipboardData .
WM_RENDERFORMAT	Envoyé au propriétaire du Presse-papiers s’il a retardé le rendu d’un format de Presse-papiers spécifique et si une application a demandé des données dans ce format. Le propriétaire du Presse-papiers doit afficher les données dans le format spécifié et les placer dans le Presse-papiers en appelant la fonction SetClipboardData .
WM_SIZECLIPBOARD	Envoyé au propriétaire du Presse-papiers par une fenêtre de visionneuse du Presse-papiers lorsque le Presse-papiers contient des données au format CF_OWNERDISPLAY et que la zone cliente de la visionneuse du Presse-papiers a changé de taille.
WM_VSCROLLCLIPBOARD	Envoyé au propriétaire du Presse-papiers par une fenêtre de visionneuse du Presse-papiers lorsque le Presse-papiers contient des données au format CF_OWNERDISPLAY et qu’un événement se produit dans la barre de défilement verticale de la visionneuse du Presse-papiers. Le propriétaire doit faire défiler l’image du Presse-papiers et mettre à jour les valeurs de la barre de défilement.

Structures

Nom	Description
METAFILEPICT	Définit le format d’image de métafichier utilisé pour échanger des données de métafichier dans le Presse-papiers.