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 de presse-papiers. Une fenêtre peut placer plusieurs objets dans le presse-papiers, chacun représentant les mêmes informations dans un format de presse-papiers différent. 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 couper et copier et récupère les données du presse-papiers pour les opérations de collage.
Format de presse-papiers HTML
Décrit le format de presse-papiers HTML.
Utilisation du presse-papiers
Une fenêtre de la visionneuse du presse-papiers affiche le contenu actuel du presse-papiers et reçoit des messages lorsque le contenu du presse-papiers change.
Référence du presse-papiers
Contient la référence de l’API.

Fonctions du presse-papiers

Nom Description
AddClipboardFormatListener
Place la fenêtre donnée dans la liste de l’écouteur de format presse-papiers géré par le système.
ChangeClipboardChain
Supprime une fenêtre spécifiée de la chaîne de visionneuses de presse-papiers.
CloseClipboard
Ferme le presse-papiers.
CountClipboardFormats
Récupère le nombre de formats de données différents actuellement dans le presse-papiers.
EmptyClipboard
Vide le presse-papiers et libère les handles des données dans le presse-papiers. La fonction affecte ensuite la propriété du presse-papiers à la fenêtre dans 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 ordonné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 format spécifie un format de presse-papiers disponible, et la fonction retourne le format de presse-papiers suivant disponible.
GetClipboardData
Récupère des données du presse-papiers dans un format spécifié. Le presse-papiers doit avoir été ouvert précédemment.
GetClipboardFormatName
Récupère, à partir du 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 active.
GetClipboardViewer
Récupère le handle de la première fenêtre dans la chaîne du presse-papiers.
GetOpenClipboardWindow
Récupère le handle de la fenêtre dans 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 de 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 à des fins d’examen et empêche les 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 de format presse-papiers gérée par le système.
SetClipboardData
Place les données dans le presse-papiers dans un format de presse-papiers spécifié. La fenêtre doit être le propriétaire du presse-papiers actuel, et l’application doit avoir appelé la fonction OpenClipboard . (Lors de la réponse 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 de presse-papiers. La visionneuse du presse-papiers Windows reçoit 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 d’édition ou une zone de liste déroulante pour supprimer (effacer) la sélection actuelle du contrôle d’édition.
_copie WM
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 de _ texte CF .
découpe WM _
Envoyé à un contrôle d’édition 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 au format CF _ .
_coller WM
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 à l’emplacement actuel du signe insertion. Les données sont insérées uniquement si le presse-papiers contient des données au format de _ texte CF .

Notifications du presse-papiers

Nom Description
_ASKCBFORMATNAME WM
Envoyé au propriétaire du presse-papiers par une fenêtre de la visionneuse du presse-papiers pour demander le nom d’un format de presse-papiers CF _ OWNERDISPLAY .
_CHANGECBCHAIN WM
Envoyé à la première fenêtre de la chaîne du presse-papiers lorsqu’une fenêtre est supprimée de la chaîne.
_CLIPBOARDUPDATE WM
Envoyé lorsque le contenu du presse-papiers a changé.
_DESTROYCLIPBOARD WM
Envoyé au propriétaire du presse-papiers lorsqu’un appel à la fonction EmptyClipboard vide le presse-papiers.
_DRAWCLIPBOARD WM
Envoyé à la première fenêtre de la chaîne du presse-papiers lorsque le contenu du presse-papiers change. Cela permet à une fenêtre de la visionneuse du presse-papiers d’afficher le nouveau contenu du presse-papiers.
_HSCROLLCLIPBOARD WM
Envoyé au propriétaire du presse-papiers par une fenêtre de la 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.
_PAINTCLIPBOARD WM
Envoyé au propriétaire du presse-papiers par une fenêtre de la 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 doit être redessinée.
_RENDERALLFORMATS WM
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 restituer les données dans tous les formats qu’il est en charge de générer et placer les données dans le presse-papiers en appelant la fonction SetClipboardData .
_RENDERFORMAT WM
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 restituer les données dans le format spécifié et les placer dans le presse-papiers en appelant la fonction SetClipboardData .
_SIZECLIPBOARD WM
Envoyé au propriétaire du presse-papiers par une fenêtre de la 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.
_VSCROLLCLIPBOARD WM
Envoyé au propriétaire du presse-papiers par une fenêtre de la 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 l’échange de données de métafichier via le presse-papiers.