将邮件和附件拖放到 Outlook 加载项的任务窗格中

在 Outlook 网页版 和新的 Windows 版 Outlook 中，使用 Office.context.mailbox.addHandlerAsync 方法在 JavaScript 文件中为 Office.EventType.DragAndDropEvent 事件创建处理程序。 DragAndDropEvent事件发生时，处理程序会收到 DragAndDropEventArgs 对象，以便确定用户何时在任务窗格上拖动项、何时将项拖放到任务窗格中，以及与该项关联的数据。 根据是否发生了拖放事件，对象的 dragAndDropEventData 属性 DragAndDropEventArgs 将返回 DragoverEventData 或 DropEventData 对象。 这些对象提供有关鼠标指针的位置以及要传输到任务窗格的数据的信息。

将消息拖动到任务窗格时，它们将作为.eml文件删除。 已删除的附件将保留其当前格式。 有关支持类型的列表，请参阅 支持的项类型。

以下示例演示如何实现拖放功能。

// Handle the DragAndDropEvent event.
Office.context.mailbox.addHandlerAsync(
    Office.EventType.DragAndDropEvent,
    (event) => {
        console.log(`Event occurred: ${event.type}`);
        const eventData = event.dragAndDropEventData;

        // Get the file name and the contents of the items dropped into the task pane.
        if (eventData.type == "drop") {
            const files = eventData.dataTransfer.files;
            files.forEach((file) => {
                const content = file.fileContent;
                const name = file.name;

                // Add operations to process the item here, such as uploading the file to a CRM system.
            });
        }
    },
    (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.error("Failed to add event handler:", asyncResult.error.message); 
            return;
        }

        console.log("Event handler added successfully.");
    }
);

试用

尝试使用交互式示例，查看拖放功能在作中。 安装 Outlook 加载项Script Lab，然后运行“将项目拖放到任务窗格”示例。

若要了解详细信息，请参阅使用 Script Lab 探索 Office JavaScript API。

在 Outlook on Windows (经典) 和 Mac 中，使用 HTML 拖放 API 来处理 DragEvent DOM 事件。 DragEvent使用 对象，可以确定用户何时在任务窗格上拖动项、何时将项拖放到任务窗格中，以及与该项关联的数据。 将邮件拖放到任务窗格中时，其格式因 Outlook 客户端而异。

• Windows (经典) ：已删除为.msg文件。
• Mac：作为.eml文件删除。

放入任务窗格的附件将保留其当前格式。 有关支持类型的列表，请参阅 支持的项类型。