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.