contents.gifprev1.gifnext1.gif

WRITE_CLIPBOARD

Writes contents of specified buffer, range, or string to clipboard.

Description:

WRITE_CLIPBOARD places the text passed in the second parameter to the window system clipboard. The first argument is a string naming the clipboard entry the text should be added to. Note that most windowing systems do not support this construct. This value can be a zero length string.

To use WRITE_CLIPBOARD, nu/TPU requires the windowing system to properly create, maintain, and allow access to the clipboard. WRITE_ CLIPBOARD does not function in NODISPLAY mode.

Syntax:

WRITE_CLIPBOARD (clipboard_label, text )

Valid text types are: Buffer, Range or String.

Example:

This example writes the message buffer to the clipboard.

WRITE_CLIPBOARD ("", message_buffer);

Errors:

TPU$_CLIPBOARDLOCKED Another application locked clipboard.

TPU$_CLIPBOARDZERO Data has length 0.

TPU$_NORETURNVALUE Doesn't return a value.

TPU$_REQUIRESWINDOWS Requires a windowed environment.

TPU$_TRUNCATE String length too long; had to be shortened.

Related Builtins:

GET_CLIPBOARD

READ_CLIPBOARD

WRITE_GLOBAL_SELECT