# gClipboard

Definition: | include xpGUI.e gdx id = gClipboard()
Description: | Creates an element that allows access to the clipboard. Returns: the identifier of the created element, an exception is thrown if it cannot be created (eg/ie another application has locked it).
pwa/p2js: | Supported. Note the browser may prohibit access to the clipboard when it is not the direct consequence of user interaction. Historically such restrictions have been rudely toggled on and off between releases in an alarmingly disturbing fashion.
Attributes: |
TEXT+ | copy or paste text to or from the clipboard. If set to NULL clears the clipboard data.
TEXTAVAILABLE | (read-only) returns true when the clipboard contains text, false otherwise.
Example: |
    gdx clipboard = IupClipboard();
    gSetAttribute(clipboard, "TEXT", gGetAttribute(text, "VALUE"));
    -- and/or
    gSetAttribute(text, "VALUE", gGetAttribute(clipboard, "TEXT"));