clearData method
[This documentation is preliminary and is subject to change.]
Removes one or more data formats from the clipboard through the dataTransfer object or the clipboardData object.
Syntax
VARIANT_BOOL retVal = object.clearData(format);
Standards information
There are no standards that apply here.
Parameters
- format [in, optional]
-
Type: BSTR
A BSTR that specifies one or more of the following data format values.
Remarks
If no format parameter is passed, the data formats are cleared.
For drag-and-drop operations, the IHTMLDataTransfer::clearData method of the dataTransfer object is used generally in source events, such as HTMLFrameSiteEvents::ondragstart. When you override the default behavior of the target, use IHTMLDataTransfer::clearData in the HTMLFrameSiteEvents::ondrop event. It is particularly useful for selectively removing data formats when multiple formats are specified.
See also
- Reference
- IHTMLDataTransfer::getData
- IHTMLDataTransfer::setData
- Conceptual
- About DHTML Data Transfer
Build date: 6/12/2012