Office.DropEventData interface

Stellt das DragAndDropEventArgs.dragAndDropEventData Objekt dar, wenn Nachrichten oder Dateianlagen im Aufgabenbereich eines Add-Ins abgelegt werden.

Hinweise

API-Satz: Postfach 1.5

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

Verwendet von

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

dataTransfer

Ruft die Nachrichten oder Dateianlagen ab, die in den Aufgabenbereich eines Add-Ins gezogen und abgelegt werden.

pageX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt. Die Position entspricht relativ zum linken Rand von Outlook im Web oder des neuen Outlook unter Windows-Clientfensters.

pageY

Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixeln darstellt. Die Position entspricht relativ zum oberen Rand des Clientfensters von Outlook im Web oder des neuen Outlook unter Windows.

taskPaneX

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

taskPaneY

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

type

Ruft den Typ des Drag-and-Drop-Ereignisses ab. Das Ereignis tritt auf, wenn Nachrichten drop oder Dateianlagen im Aufgabenbereich eines Add-Ins abgelegt werden.

Details zur Eigenschaft

dataTransfer

Ruft die Nachrichten oder Dateianlagen ab, die in den Aufgabenbereich eines Add-Ins gezogen und abgelegt werden.

dataTransfer: DroppedItems;

Eigenschaftswert

Hinweise

API-Satz: Postfach 1.5

pageX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt. Die Position entspricht relativ zum linken Rand von Outlook im Web oder des neuen Outlook unter 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 Pixeln darstellt. Die Position entspricht relativ zum oberen Rand des Clientfensters von Outlook im Web oder des neuen Outlook unter Windows.

pageY: number;

Eigenschaftswert

number

Hinweise

API-Satz: Postfach 1.5

taskPaneX

Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt. Die Position entspricht 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 Pixeln 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 Ereignis tritt auf, wenn Nachrichten drop oder Dateianlagen im Aufgabenbereich eines Add-Ins abgelegt werden.

type: "drop";

Eigenschaftswert

"drop"

Hinweise

API-Satz: Postfach 1.5