getData method

[This documentation is preliminary and is subject to change.]

Gets the data in the specified format from the clipboard through the dataTransfer object or the clipboardData object.

Syntax

VARIANT retVal = object.getData(format);

Standards information

There are no standards that apply here.

Parameters

format [in]

Type: BSTR

A BSTR that specifies one of the following data format values.

Text

Gets data formatted as text.

URL

Gets data formatted as a URL.

Remarks

The IHTMLDataTransfer::getData method enforces cross-frame security and allows data transfers only in the same domain. To the user, this means that a selection that is dragged between different security protocols, such as HTTP and HTTPS, fails. In addition, that a selection that is dragged between two instances of the application with different security levels, where the first instance is set to medium and the second is set to high, fails. Finally, that a selection that is dragged into the application from another drag-enabled application, such as Microsoft Word, also fails.

See also

Reference

IHTMLDataTransfer::clearData

IHTMLDataTransfer::setData

Conceptual

About DHTML Data Transfer

 

 

Build date: 6/12/2012