Click above to get retro games delivered to your door ever month!

SetClipbData()
Put data into the clipboard
------------------------------------------------------------------------------

Syntax
SetClipbData( <nFormat>, <cData> )   -->   hData

Arguments
<nFormat> is an integer specifying the format of the data.  It
may be one of the CF_* values below, or a format registered
using RegClipbFormat().

<cData> is the data to be put in the clipboard.  This string
may contain any characters, including nulls (chr(0)).
However, some of the formats ignore data after a null.

Returns
If successful, a handle to the data is returned as a non-zero
numeric.  Otherwise, zero (0) is returned.  This value is only
useful for error-checking.

Description
This function places data into the clipboard, which must have
been opened using the OpenClipboard() function.  Applications
commonly put the same data into the clipboard in more than one
format, so that other applications can choose a format they
understand.

The pre-defined clipboard formats are:

     <nFormat>      means

     CF_BITMAP      the data is a bitmap

     CF_DIF         the data is in Data Interchange Format

     CF_OEMTEXT     the data is a string, using the IBM PC character set
                    (lines end with CR, LF; any null terminates the data)

     CF_PALETTE     a colour palette

     CF_RIFF        the data is in Resource Interchange File Format

     CF_SYLK        Microsoft Symbolic Link format

     CF_TEXT        a string, using the Windows character set
                    (lines end with CR, LF; any null terminates the data)

     CF_TIFF        Tag Image File Format data

     CF_WAVE        sound wave data


Example
if empty( SetClipbData( CF_OEMTEXT, "My Data For The Clipboard" ) )
     // failed
endif