Freigeben über


Office.DragoverEventData interface

Stellt das DragAndDropEventArgs.dragAndDropEventData -Objekt dar, wenn Nachrichten oder Dateianlagen über den Aufgabenbereich eines Add-Ins gezogen werden.

Hinweise

[ API-Satz: Postfach 1.5 ]

Weitere Informationen zum Drag-and-Drop-Feature und dessen Implementierung für verschiedene Outlook-Clients finden Sie unter Ziehen und Ablegen von Nachrichten und Anlagen in den Aufgabenbereich eines Outlook-Add-Ins.

Beispiele

// 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}`);
    console.log(`x-coordinate relative to task pane: ${eventData.taskPaneX}, y-coordinate relative to task pane: ${eventData.taskPaneY}`);

    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); })}`);
      });
    }
  });
}

Eigenschaften

pageX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixel darstellt. Die Position ist relativ zum linken Rand des Outlook im Web oder des neuen Outlook für Windows-Clientfensters.

pageY

Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixel darstellt. Die Position ist relativ zum oberen Rand des Outlook im Web oder des neuen Outlook für Windows-Clientfensters.

taskPaneX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixel darstellt. Die Position ist relativ zum linken Rand des Aufgabenbereichs des Add-Ins.

taskPaneY

Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixel darstellt. Die Position ist relativ zum oberen Rand des Aufgabenbereichs des Add-Ins.

type

Ruft den Typ des Drag-and-Drop-Ereignisses ab. Das dragover Ereignis tritt auf, wenn Nachrichten oder Dateianlagen über den Aufgabenbereich eines Add-Ins gezogen werden.

Details zur Eigenschaft

pageX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixel darstellt. Die Position ist relativ zum linken Rand des Outlook im Web oder des neuen Outlook für Windows-Clientfensters.

pageX: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: Postfach 1.5 ]

pageY

Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixel darstellt. Die Position ist relativ zum oberen Rand des Outlook im Web oder des neuen Outlook für Windows-Clientfensters.

pageY: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: Postfach 1.5 ]

taskPaneX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixel darstellt. Die Position ist relativ zum linken Rand des Aufgabenbereichs des Add-Ins.

taskPaneX: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: Postfach 1.5 ]

taskPaneY

Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixel darstellt. Die Position ist relativ zum oberen Rand des Aufgabenbereichs des Add-Ins.

taskPaneY: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: Postfach 1.5 ]

type

Ruft den Typ des Drag-and-Drop-Ereignisses ab. Das dragover Ereignis tritt auf, wenn Nachrichten oder Dateianlagen über den Aufgabenbereich eines Add-Ins gezogen werden.

type: "dragover";

Eigenschaftswert

"dragover"

Hinweise

[ API-Satz: Postfach 1.5 ]