通过

Office.DragoverEventData interface

包:
outlook

表示 DragAndDropEventArgs.dragAndDropEventData 在加载项的任务窗格上拖动邮件或文件附件时的对象。

注解

[ API 集：邮箱 1.5 ]

若要详细了解拖放功能以及如何跨各种 Outlook 客户端实现该功能，请参阅 将邮件和附件拖放到 Outlook 外接程序的任务窗格中。

示例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/80-events/drag-drop-item.yaml

function dragAndDropEventHandler(event) {
    Office.context.mailbox.addHandlerAsync(Office.EventType.DragAndDropEvent, (event) => {
    console.log(`Event type: ${event.type}`);

    const eventData = event.dragAndDropEventData;
    console.log(`x-coordinate: ${eventData.pageX}, y-coordinate: ${eventData.pageY}`);

    if (eventData.type == "drop") {
      console.log("Items dropped into task pane.");
      const files = eventData.dataTransfer.files;
      files.forEach((file) => {
        const content = file.fileContent;
        const name = file.name;
        const fileType = file.type;
        console.log(`File name: ${name}`);
        console.log(`File type: ${fileType}`);
        console.log(`Contents: ${content.text().then((text) => { console.log(text); })}`);
      });
    }
  });
}

属性

pageX

获取鼠标指针的 x 坐标，该坐标表示水平位置（以像素为单位）。 该位置相对于Outlook 网页版或新的 Outlook on Windows 客户端窗口的左边缘。
pageY

获取鼠标指针的 y 坐标，该坐标表示垂直位置（以像素为单位）。 该位置相对于Outlook 网页版或新的 Windows 上的 Outlook 客户端窗口的上边缘。
type

获取拖放事件的类型。 将 dragover 邮件或文件附件拖动到加载项的任务窗格上时，会发生该事件。

属性详细信息

pageX

获取鼠标指针的 x 坐标，该坐标表示水平位置（以像素为单位）。 该位置相对于Outlook 网页版或新的 Outlook on Windows 客户端窗口的左边缘。

pageX: number;

属性值

number

注解

[ API 集：邮箱 1.5 ]

pageY

获取鼠标指针的 y 坐标，该坐标表示垂直位置（以像素为单位）。 该位置相对于Outlook 网页版或新的 Windows 上的 Outlook 客户端窗口的上边缘。

pageY: number;

属性值

number

注解

[ API 集：邮箱 1.5 ]

type

获取拖放事件的类型。 将 dragover 邮件或文件附件拖动到加载项的任务窗格上时，会发生该事件。

type: "dragover";

属性值

"dragover"

注解

[ API 集：邮箱 1.5 ]