dataTransfer

HTML (DHTML)

CUSTOM 元素 | curstom 对象 DD 元素 | dd 对象 DHTML 对象

dataTransfer 对象


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

成员表

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

属性

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

方法

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

注释

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

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

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

示例

下面的例子使用了 dataTransfer 对象的 setDatagetData 方法通过快捷菜单执行拖曳操作。

<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