# Clipboard Functions

ARWEN supports copying & retrieving data to/from the Windows clipboard.
Copy

    function getClipboardText()

Returns a sequence containing the text if successful. If a failure occurs it will return empty sequence.
The user can also use `getText(CLIPBOARD)` to perform the same function.
Copy

    procedure setClipboardText(sequence text)

Copies the text data into the clipboard. The user can also call `setText(CLIPBOARD,text)` to perfrom the same action.
Copy

    procedure copyDibToClipboard(integer id)

Will copy a DibSection into the Windows clipboard.
Copy

    procedure loadDibFromClipboard(integer id)

Will create a DibSection from the image in the Windows clipboard.
`id` refers to the window id of the "owner" of the clipboard - simply pass the id of the main window in the application. The return value is either the id of a new DIB section or NULL if an error occurs.