Outlook-Add-In-API-Anforderungssatz 1.5

Die Outlook-Add-In-API-Teilmenge der Office JavaScript-API enthält Objekte, Methoden, Eigenschaften und Ereignisse, die Sie in einem Outlook-Add-In verwenden können.

Hinweis

Diese Dokumentation bezieht sich auf einen anderen Anforderungssatz als den aktuellen.

Neuigkeiten in 1.5

Postfachanforderungssatz 1.5 enthält alle Funktionen von Anforderungssatz 1.4. Zusätzlich wurden die folgenden Funktionen implementiert.

  • Es wurde Unterstützung für anheftbare Aufgabenbereiche hinzugefügt.
  • Es wurde Unterstützung für den Aufruf von REST-APIs hinzugefügt.

    Wichtig

    Outlook REST v2.0- und Beta-Endpunkte sind veraltet. Verwenden Sie stattdessen die Microsoft Graph-REST-API .

  • Unterstützung hinzugefügt, um eine Anlage als inline zu markieren.
  • Unterstützung für das programmgesteuerte Schließen eines Aufgabenbereichs oder Dialogfelds wurde hinzugefügt.
  • Unterstützung für die Eigenschaft Office.context.diagnose und die zugehörigen Objekte wurde hinzugefügt.
  • Es wurde ein Ereignis hinzugefügt, um festzustellen, wann ein Outlook-E-Mail-Element zur Ansicht ausgewählt wird, während der Aufgabenbereich des Add-Ins angeheftet ist.

API-Liste

In der folgenden Tabelle sind die APIs aufgeführt, die im Postfach-Anforderungssatz 1.5 eingeführt wurden. Die API-Referenzdokumentation für alle APIs, die vom Postfachanforderungssatz 1.5 oder früher unterstützt werden, finden Sie unter Outlook-APIs.

Klasse Felder Beschreibung
DragAndDropEventArgs dragAndDropEventData Ruft die Details zur Mauszeigerposition im Aufgabenbereich eines Add-Ins und zu den Meldungen oder Dateianlagen ab, die in den Aufgabenbereich gezogen und abgelegt werden.
type Ruft den Typ des Ereignisses ab.
DragoverEventData SeiteX Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt.
pageY Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixeln darstellt.
taskPaneX Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt.
Aufgabenbereich Y Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixeln darstellt.
type Ruft den Typ des Drag-and-Drop-Ereignisses ab.
DropEventData dataTransfer Ruft die Nachrichten oder Dateianlagen ab, die in den Aufgabenbereich eines Add-Ins gezogen und abgelegt werden.
SeiteX Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt.
pageY Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixeln darstellt.
taskPaneX Ruft die x-Koordinate des Mauszeigers ab, der die horizontale Position in Pixeln darstellt.
Aufgabenbereich Y Ruft die y-Koordinate des Mauszeigers ab, der die vertikale Position in Pixeln darstellt.
type Ruft den Typ des Drag-and-Drop-Ereignisses ab.
DroppedItemDetails fileContent Ruft den Inhalt der Datei ab, die gezogen und abgelegt wird.
name Ruft den Namen der Datei ab, die gezogen und abgelegt wird.
type Ruft den Typ der Datei ab, die gezogen und abgelegt wird.
DroppedItems Dateien Ruft ein Array der Nachrichten oder Dateianlagen ab, die in den Aufgabenbereich eines Add-Ins gezogen und dort abgelegt werden.
Postfach addHandlerAsync(eventType: Office.EventType | string, handler: any, callback?: (asyncResult: Office.AsyncResult<void>) => void) Fügt einen Ereignishandler für ein unterstütztes Ereignis hinzu.
addHandlerAsync(eventType: Office.EventType | string, handler: any, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Fügt einen Ereignishandler für ein unterstütztes Ereignis hinzu.
getCallbackTokenAsync(options: Office.AsyncContextOptions & { isRest?: boolean }, callback: (asyncResult: Office.AsyncResult<string>) => void) Ruft eine Zeichenfolge ab, die ein Token enthält, das zum Aufrufen von REST-APIs oder Exchange-Webdiensten (Exchange Web Services, EWS) verwendet wird.
removeHandlerAsync(eventType: Office.EventType | string, callback?: (asyncResult: Office.AsyncResult<void>) => void) Entfernt die Ereignishandler für einen unterstützten Ereignistyp.
removeHandlerAsync(eventType: Office.EventType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void) Entfernt die Ereignishandler für einen unterstützten Ereignistyp.
restUrl Ruft die URL des REST-Endpunkts für das betreffende E-Mail-Konto ab.

Ereignisse

In der folgenden Tabelle sind die in Anforderungssatz 1.5 eingeführten Ereignisse aufgeführt. Eine Liste aller unterstützten Ereignisse, die mit der addHandlerAsync and-Methode removeHandlerAsync behandelt werden können, finden Sie unter Office.EventType.

Ereignis Beschreibung Object
ItemChanged Während der Aufgabenbereich des Add-Ins angeheftet ist, ist ein anderes Outlook-Element zur Ansicht ausgewählt. Postfach

Siehe auch

  • Last updated on