UDF > Clipboard >

_ClipBoard_GetData

R�cup�re les donn�es du presse-papiers dans un format sp�cifi�

#include <Clipboard.au3>
_ClipBoard_GetData ( [$iFormat = 1] )

Param�tre

$iFormat [optionnel] Sp�cifie un format de presse-papiers:
$CF_TEXT - Format texte
$CF_BITMAP - Handle d'une image bitmap (HBITMAP)
$CF_METAFILEPICT - Handle d'un m�tafichier d'image (METAFILEPICT)
$CF_SYLK - Format Microsoft Symbolic Link (SYLK)
$CF_DIF - Format Data Interchange de Software Arts
$CF_TIFF - Format Tagged Image File
$CF_OEMTEXT - Format texte contenant des caract�res dans le jeu de caract�res OEM
$CF_DIB - Structure de BITMAPINFO suivie par les bits du bitmap
$CF_PALETTE - Handle d'une palette de couleurs
$CF_PENDATA - Donn�es pour les extensions de crayon � Pen Computing
$CF_RIFF - Repr�sente les donn�es audio au format RIFF
$CF_WAVE - Repr�sente les donn�es audio au format WAVE
$CF_UNICODETEXT - Format texte Unicode
$CF_ENHMETAFILE - Handle d'un m�tafichier �tendu (HENHMETAFILE)
$CF_HDROP - Handle d'un type HDROP qui identifie une liste de fichiers
$CF_LOCALE - Handle d'un identifiant de param�tres r�gionaux associ�s au texte du presse-papiers
$CF_DIBV5 - Structure BITMAPV5HEADER suivie par les couleurs du bitmap et des bits du bitmap
$CF_OWNERDISPLAY - Format d'affichage propri�taire
$CF_DSPTEXT - Format d'affichage de texte associ� � un format priv�
$CF_DSPBITMAP - Format d'affichage de bitmap associ� � un format priv�
$CF_DSPMETAFILEPICT - Format d'affichage de m�tafichier d'image associ� � un format priv�
$CF_DSPENHMETAFILE - Format d'affichage de m�tafichier am�lior� associ� � un format priv�

Valeur de retour

Succ�s: Retourne du texte pour les formats texte ou des donn�es binaires pour tous les autres formats
@extended est d�fini avec le nombre de caract�res du texte, ou le nombre d'octets du Binary
�chec: Retourne 0

Remarque

Cette fonction effectue toutes les �tapes n�cessaire pour obtenir des donn�es � partir du presse-papiers. Elle v�rifie si le format de donn�es est disponible, ouvre le presse-papiers, ferme le presse-papiers et retourne les donn�es dans l'un des deux formats : format String pour les types de donn�es $CF_TEXT, $CF_OEMTEXT, ou $CF_UNICODETEXT, ou format Binary pour tous les autres types.
Si vous avez besoin d'un degr� de contr�le plus fin sur la r�cup�ration de donn�es � partir du presse-papiers, vous pouvez utiliser la fonction _ClipBoard_GetDataEx().

En relation

_ClipBoard_GetDataEx, _ClipBoard_SetData, _ClipBoard_SetDataEx

Exemple

#include <Clipboard.au3>
#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>

Global $g_idMemo

Example()

Func Example()
    Local $id_SetData, $id_GetData

    ; Cr�e une GUI
    GUICreate("Clipboard", 600, 450)
    $g_idMemo = GUICtrlCreateEdit("", 2, 2, 596, 396, $WS_VSCROLL)
    GUICtrlSetFont($g_idMemo, 9, 400, 0, "Courier New")
    $id_SetData = GUICtrlCreateButton("Set ClipBoard Data", 150, 410, 120, 30)
    $id_GetData = GUICtrlCreateButton("Get ClipBoard Data", 300, 410, 120, 30)
    GUISetState(@SW_SHOW)

    ; Boucle jusqu'� ce que l'utilisateur quitte.
    Local $iMsg
    Do
        $iMsg = GUIGetMsg() 
        Switch $iMsg
            Case $id_SetData
                _ClipBoard_SetData("ClipBoard Library")
            Case $id_GetData
                MemoWrite(_ClipBoard_GetData())
        EndSwitch
    Until $iMsg = GUI_EVENT_CLOSE 
EndFunc   ;==>Example

; Ecrit un message dans memo
Func MemoWrite($sMessage = "")
    GUICtrlSetData($g_idMemo, $sMessage & @CRLF, 1)
EndFunc   ;==>MemoWrite