Voici la liste des fonctions de la rubrique AutoIt > Clipboard.
Cliquez sur le nom d'une fonction pour obtenir une description détaillée.
Quand vous les utilisez, vous devez ajouter: #include <WinAPISys.au3>.
| Fonction UDF | Description |
|---|---|
| _ClipBoard_ChangeChain | Supprime une fenêtre spécifiée de la chaîne des vues du presse-papiers |
| _ClipBoard_Close | Ferme le presse-papiers |
| _ClipBoard_CountFormats | Obtient le nombre de formats de données différents actuellement dans le presse-papiers |
| _ClipBoard_Empty | Vide le presse-papiers et libère les handles des données du presse-papiers |
| _ClipBoard_EnumFormats | Énumère les formats de données actuellement disponibles dans le presse-papiers |
| _ClipBoard_FormatStr | Retourne une représentation chaîne d'un format standard de presse-papiers |
| _ClipBoard_GetData | Récupère les données du presse-papiers dans un format spécifié |
| _ClipBoard_GetDataEx | Récupère les données du presse-papiers dans un format spécifié |
| _ClipBoard_GetFormatName | Récupère le nom du format enregistré spécifié |
| _ClipBoard_GetOpenWindow | Récupère le handle de la fenêtre qui a actuellement le presse-papiers ouvert |
| _ClipBoard_GetOwner | Obtient le handle de la fenêtre du propriétaire actuel du presse-papiers |
| _ClipBoard_GetPriorityFormat | Obtient le premier format disponible du presse-papiers dans la liste spécifiée |
| _ClipBoard_GetSequenceNumber | Récupère le numéro de séquence du presse-papiers pour la station de fenêtre actuelle |
| _ClipBoard_GetViewer | Récupère la handle de la première fenêtre dans la chaîne des visualiseurs du presse-papiers |
| _ClipBoard_IsFormatAvailable | Détermine si le presse-papiers contient des données dans le format spécifié |
| _ClipBoard_Open | Ouvre le presse-papiers et empêche d'autres applications de modifier le presse-papiers |
| _ClipBoard_RegisterFormat | Enregistre un nouveau format de presse-papiers |
| _ClipBoard_SetData | Place des données dans le presse-papiers dans un format spécifié de presse-papiers |
| _ClipBoard_SetDataEx | Place des données dans le presse-papiers dans un format spécifié de presse-papiers |
| _ClipBoard_SetViewer | Ajoute la fenêtre spécifiée à la chaîne des vues du presse-papiers |
Le presse-papiers est un ensemble de fonctions et de messages permettant aux applications de transférer des données. Comme toutes les applications ont accès au presse-papiers, les données peuvent être facilement transférées entre applications ou au sein d'une application.
Le presse-papiers est piloté par l'utilisateur. Une fenêtre doit transférer des données vers ou depuis le presse-papiers uniquement en réponse à une commande de l'utilisateur. Une fenêtre ne doit pas utiliser le presse-papiers pour transférer des données à l'insu de l'utilisateur.
Un objet mémoire du presse-papiers peut être dans n'importe quel format de données, appelé format de presse-papiers. Chaque format est identifié par une valeur entière non signée. Pour les formats de presse-papiers standards (prédéfinis), cette valeur est une constante définie dansUn utilisateur effectue généralement des opérations de Presse-papiers en choisissant des commandes dans le menu Edition d'une application . Voici une brève description des commandes du presse-papiers standard.
| Couper | Place une copie de la sélection actuelle dans le Presse-papiers et supprime la sélection du document. Le contenu précédent du presse-papiers est détruit. |
| Copier | Place une copie de la sélection actuelle dans le presse-papiers. Le document reste inchangé. Le contenu précédent du presse-papiers est détruit. |
| Coller | Remplace la sélection actuelle par le contenu du presse-papiers. Le contenu du presse-papiers n'est pas modifié. |
| Supprimer | Supprime la sélection actuelle du document. Le contenu du presse-papiers n'est pas modifié. Cette commande n'implique pas le Presse-papiers, mais elle devrait apparaître avec les commandes du Presse-papiers dans le menu Edition. |
Le presse-papier, pour chaque station de fenêtre, a un numéro de séquence associé. Ce nombre est incrémenté chaque fois que le contenu du presse-papiers change.
Pour obtenir le numéro de séquence du Presse-papiers, appelez la fonction _Clipboard_GetSequenceNumber().
Une visionneuse de presse-papiers est une fenêtre qui affiche le contenu actuel du presse-papiers. La fenêtre de la visionneuse de presse-papiers est pratique pour l'utilisateur et n'affecte pas les fonctions de transaction de données du presse-papiers.
En règle générale, une fenêtre de visionneuse de presse-papiers peut afficher au moins les trois formats les plus courants: $CF_TEXT , $CF_BITMAP et $CF_METAFILEPICT. Si une fenêtre ne permet pas de visualiser les données dans l'un de ces trois formats, elle doit fournir les données dans un format d'affichage ou utiliser un format d'affichage propriétaire.
Un chainage de visionneuses de presse-papiers est l'enchaînement de deux ou plusieurs entités de sorte qu'elles dépendent les unes des autres pour l'opération. Cette interdépendance (chaînage) permet à toutes les applications de visionneuse de presse-papiers en cours d'exécution de recevoir les messages envoyés au Presse-papiers actuel.
Une fenêtre s'ajoute à la chaîne de la visionneuse du Presse-papiers en appelant la fonction _Clipboard_SetViewer(). La valeur de retour est le handle de la fenêtre suivante de la chaîne. Pour récupérer le handle de la première fenêtre de la chaîne, appelez la fonction _Clipboard_GetViewer().
Chaque fenêtre de la visionneuse de presse-papiers doit garder une trace de la fenêtre suivante dans la chaîne des visionneuses du presse-papiers. Lorsque le contenu du presse-papiers change, le système envoie un message WM_DRAWCLIPBOARD à la première fenêtre de la chaîne.
Après la mise à jour de son affichage, chaque fenêtre des visionneuses du presse-papiers doit transmettre ce message à la fenêtre suivante de la chaîne.
Avant de fermer, une fenêtre de visionneuse de presse-papiers doit se retirer de la chaîne de visionneuse du Presse-papiers en appelant la fonction _Clipboard_ChangeChain(). Le système envoie ensuite un message WM_CHANGECBCHAIN à la première fenêtre de la chaîne.
Un format d'affichage est un format de presse-papiers utilisé pour afficher des informations dans une fenêtre de visionneuse de presse-papiers. Un propriétaire de Presse-papiers qui utilise un format de Presse-papiers privé ou enregistré, et aucun des formats standard les plus courants, doit fournir des données dans un format d'affichage pour les afficher dans une fenêtre de visualiseur de Presse-papiers. Les formats d'affichage sont destinés à la visualisation uniquement et ne doivent pas être collés dans un document.
Les quatre formats d'affichage sont: $CF_DSPBITMAP , $CF_DSPMETAFILEPICT , $CF_DSPTEXT et $CF_DSPENHMETAFILE . Ces formats d'affichage sont rendus de la même manière que les formats standard, à savoir: $CF_BITMAP , $CF_TEXT , $CF_METAFILEPICT et $CF_ENHMETAFILE .
Pour un propriétaire de Presse-papiers qui n'utilise aucun des formats de Presse-papiers standard, une alternative consiste à utiliser le format d'affichage propriétaire ($CF_OWNERDISPLAY).
En utilisant le format d'affichage propriétaire, le propriétaire du presse-papiers peut éviter le surdébit des données de rendu dans un format supplémentaire en prenant directement le contrôle sur la peinture de la fenêtre de la visionneuse de presse-papiers. La fenêtre de la visionneuse envoie des messages au propriétaire du presse-papiers lorsqu'une partie de la fenêtre doit être repeinte ou lorsque la fenêtre est défilée ou redimensionnée.