###User Defined Function###
_ClipBoard_GetDataEx

###Description###
Retrieves data from the clipboard in a specified format

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


###Parameters###
@@ParamTable@@
$iFormat
	[optional] Specifies a clipboard format:
	$CF_TEXT - Text format
	$CF_BITMAP - Handle to a bitmap (HBITMAP)
	$CF_METAFILEPICT - Handle to a metafile picture (METAFILEPICT)
	$CF_SYLK - Microsoft Symbolic Link (SYLK) format
	$CF_DIF - Software Arts' Data Interchange Format
	$CF_TIFF - Tagged image file format
	$CF_OEMTEXT - Text format containing characters in the OEM character set
	$CF_DIB - BITMAPINFO structure followed by the bitmap bits
	$CF_PALETTE - Handle to a color palette
	$CF_PENDATA - Data for the pen extensions to Pen Computing
	$CF_RIFF - Represents audio data in RIFF format
	$CF_WAVE - Represents audio data in WAVE format
	$CF_UNICODETEXT - Unicode text format
	$CF_ENHMETAFILE - Handle to an enhanced metafile (HENHMETAFILE)
	$CF_HDROP - Handle to type HDROP that identifies a list of files
	$CF_LOCALE - Handle to the locale identifier associated with text in the clipboard
	$CF_DIBV5 - BITMAPV5HEADER structure followed by bitmap color and the bitmap bits
	$CF_OWNERDISPLAY - Owner display format
	$CF_DSPTEXT - Text display format associated with a private format
	$CF_DSPBITMAP - Bitmap display format associated with a private format
	$CF_DSPMETAFILEPICT - Metafile picture display format associated with a private format
	$CF_DSPENHMETAFILE - Enhanced metafile display format associated with a private format
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Handle to a clipboard object in the specified format
Failure:	0
@@End@@


###Remarks###
The clipboard controls the handle that the <a href="_ClipBoard_GetData.htm">_ClipBoard_GetData()</a> function returns, not the application.
You should copy the data immediately. The application must not free the handle nor leave it locked.
The application must not use the handle after the <a href="_ClipBoard_Empty.htm">_ClipBoard_Empty()</a> or <a href="_ClipBoard_Close.htm">_ClipBoard_Close()</a> function is called, or after the <a href="_ClipBoard_SetData.htm">_ClipBoard_SetData()</a> function is called with the same clipboard format.


###Related###
_ClipBoard_SetData, _ClipBoard_GetData


###See Also###
@@MsdnLink@@ GetClipboardData


###Example###
@@IncludeExample@@
