Partager via

Office.DragoverEventData interface

Paquet:
outlook

Représente l’objet DragAndDropEventArgs.dragAndDropEventData lorsque des messages ou des pièces jointes sont glissés sur le volet Office d’un complément.

Remarques

[ Ensemble d’API : Boîte aux lettres 1.5 ]

Pour en savoir plus sur la fonctionnalité glisser-déplacer et la façon de l’implémenter sur différents clients Outlook, voir Glisser-déplacer des messages et des pièces jointes dans le volet Office d’un complément Outlook.

Exemples

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

Propriétés

pageX

Obtient la coordonnée x du pointeur de la souris qui représente la position horizontale en pixels. La position est relative au bord gauche du Outlook sur le web ou de la nouvelle fenêtre cliente Outlook sur Windows.
pageY

Obtient la coordonnée y du pointeur de la souris qui représente la position verticale en pixels. La position est relative au bord supérieur du Outlook sur le web ou à la nouvelle fenêtre du client Outlook sur Windows.
taskPaneX

Obtient la coordonnée x du pointeur de la souris qui représente la position horizontale en pixels. La position est relative au bord gauche du volet Office du complément.
taskPaneY

Obtient la coordonnée y du pointeur de la souris qui représente la position verticale en pixels. La position est relative au bord supérieur du volet Office du complément.
type

Obtient le type d’événement glisser-déplacer. L’événement dragover se produit lorsque des messages ou des pièces jointes sont glissés sur le volet Office d’un complément.

Détails de la propriété

pageX

Obtient la coordonnée x du pointeur de la souris qui représente la position horizontale en pixels. La position est relative au bord gauche du Outlook sur le web ou de la nouvelle fenêtre cliente Outlook sur Windows.

pageX: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : Boîte aux lettres 1.5 ]

pageY

Obtient la coordonnée y du pointeur de la souris qui représente la position verticale en pixels. La position est relative au bord supérieur du Outlook sur le web ou à la nouvelle fenêtre du client Outlook sur Windows.

pageY: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : Boîte aux lettres 1.5 ]

taskPaneX

Obtient la coordonnée x du pointeur de la souris qui représente la position horizontale en pixels. La position est relative au bord gauche du volet Office du complément.

taskPaneX: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : Boîte aux lettres 1.5 ]

taskPaneY

Obtient la coordonnée y du pointeur de la souris qui représente la position verticale en pixels. La position est relative au bord supérieur du volet Office du complément.

taskPaneY: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : Boîte aux lettres 1.5 ]

type

Obtient le type d’événement glisser-déplacer. L’événement dragover se produit lorsque des messages ou des pièces jointes sont glissés sur le volet Office d’un complément.

type: "dragover";

Valeur de propriété

"dragover"

Remarques

[ Ensemble d’API : Boîte aux lettres 1.5 ]