VALUE attribute

The data values in the system clipboard.

Data type: CHARACTER

Access: Readable/Writeable

Applies to: CLIPBOARD system handle

During single-item operation (with the CLIPBOARD:MULTIPLE attribute set to FALSE), reading this attribute returns all the data in the clipboard, and writing to attribute completely replaces any and all data in the clipboard. During multiple-item operation (with the CLIPBOARD:MULTIPLE attribute set to TRUE), reading this attribute returns one of several data items in the clipboard, and writing to this attribute appends a data item to a buffered value formatted to replace the data in the clipboard.

Note: In Windows, the clipboard can store a maximum of 64K of data.

If there is no data in the clipboard or the last data item has been read during a multiple-item operation, the VALUE attribute returns the Unknown value (?). Reading this attribute during either single-item or multiple-item operation has no effect on the existing clipboard data value(s). Setting the VALUE attribute to the Unknown value (?) during single- or multiple-item operation has no effect. To clear the clipboard of all data, set the VALUE attribute to the null string in a single-item operation. For more information on using the VALUE attribute, see the reference entry for the CLIPBOARD system handle.