dataTransfer 对象

提供了对于预定义的剪贴板格式的访问，以便在拖曳操作中使用。

成员表

下面的表格列出了 dataTransfer 对象引出的成员。请单击左侧的标签来选择你想要查看的成员类型。

属性

属性描述

dropEffect 设置或获取拖曳操作的类型和要显示的光标类型。

effectAllowed 设置或获取数据传送操作可应用于该对象的源元素。

方法

方法描述

clearData 通过 dataTransfer 或 clipboardData 对象从剪贴板删除一种或多种数据格式。

getData 通过 dataTransfer 或 clipboardData 对象从剪贴板获取指定格式的数据。

setData 以指定格式给 dataTransfer 或 clipboardData 对象赋予数据。

属性	描述
dropEffect	设置或获取拖曳操作的类型和要显示的光标类型。
effectAllowed	设置或获取数据传送操作可应用于该对象的源元素。

方法	描述
clearData	通过 dataTransfer 或 clipboardData 对象从剪贴板删除一种或多种数据格式。
getData	通过 dataTransfer 或 clipboardData 对象从剪贴板获取指定格式的数据。
setData	以指定格式给 dataTransfer 或 clipboardData 对象赋予数据。

注释

dataTransfer 对象使得自定义处理拖曳操作成为可能。你可通过 event 对象完成这种功能。

dataTransfer 对象可于源对象和目标对象中使用。典型用法是，setData 方法用于源事件，以便提供关于将要进行传送的数据的数据。相应的，getData 方法用于目标事件以便确保获取的数据和数据格式。

此对象在 Microsoft^® Internet Explorer 5 的脚本中可用。

示例

下面的例子使用了 dataTransfer 对象的 setData 和 getData 方法通过快捷菜单执行拖曳操作。
<HEAD>
<SCRIPT>
var sAnchorURL;
function InitiateDrag()
/*  setData 参数告诉源对象将数据传送为 URL 并提供
路径。*/
{
event.dataTransfer.setData("URL", oSource.href);
}
function FinishDrag()
/*  传递给 getData 的参数告诉目标对象所期望的数据
格式。*/
{
sAnchorURL = event.dataTransfer.getData("URL");
oTarget.innerText = sAnchorURL;
}
</SCRIPT>
</HEAD>
<BODY>
<A ID=oSource HREF="about:Example_Complete" onclick="return(false)"
ondragstart="InitiateDrag()">测试锚</A>
<SPAN ID=oTarget ondragenter="FinishDrag()">将链接拖曳到这里</SPAN>
</BODY>
此特性需要 Microsoft^® Internet Explorer 5.0 或以后版本。请单击下面的图标安装最新版本。然后重新装入此页再查看示例。

标准信息

没有应用于此对象的公共标准。

应用到

event