Office.MailboxEvent interface

Das MailboxEvent Objekt wird als Argument an den Ereignishandler eines Add-Ins übergeben, der die ereignisbasierte Aktivierung implementiert, einschließlich intelligenter Warnungen, der integrierten Spamberichtsfunktion oder der Entschlüsselung. Dadurch kann das Add-In dem Outlook-Client anzeigen, dass die Verarbeitung eines Ereignisses abgeschlossen ist.

Hinweise

API-Satz: Postfach 1.10

Mindestberechtigungsstufe: Eingeschränkt

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig:

Methoden

completed(options)

Gibt an, dass das Add-In für ereignisbasierte, Spam-Berichterstellung oder Entschlüsselung die Verarbeitung eines Ereignisses abgeschlossen hat.

Details zur Methode

completed(options)

Gibt an, dass das Add-In für ereignisbasierte, Spam-Berichterstellung oder Entschlüsselung die Verarbeitung eines Ereignisses abgeschlossen hat.

completed(options?: SmartAlertsEventCompletedOptions | SpamReportingEventCompletedOptions | MessageDecryptEventCompletedOptions): void;

Parameter

options

Office.SmartAlertsEventCompletedOptions | Office.SpamReportingEventCompletedOptions | Office.MessageDecryptEventCompletedOptions

Optional. Ein Objekt, das das Verhalten eines ereignisbasierten, Spam-Berichts- oder Entschlüsselungs-Add-Ins angibt, wenn die Verarbeitung eines Ereignisses abgeschlossen ist.

Gibt zurück

void

Hinweise

API-Satz: Postfach 1.10

Mindestberechtigungsstufe: Eingeschränkt

Anwendbarer Outlook-Modus: Compose oder Lesen

Wichtig:

  • Die Unterstützung für die integrierte Spamberichterstattung wurde mit Postfach 1.14 eingeführt.

  • Die Unterstützung für die options Zuweisung eines SmartAlertsEventCompletedOptions Objekts zum Parameter wurde in Mailbox 1.12 eingeführt.

  • Die Unterstützung für das Entschlüsselungsfeature wurde in Postfach 1.16 eingeführt.

Beispiele

// The following example sets the subject when a new message is composed.
function onNewMessageComposeHandler(event) {
    const subject = "Set by an event-based add-in!";
    Office.context.mailbox.item.subject.setAsync(
        subject,
        {
            asyncContext: event,
        },
        (asyncResult) => {
            const event = asyncResult.asyncContext;
            if (asyncResult.status === Office.AsyncResultStatus.Failed) {
                console.error("Failed to set subject: " + asyncResult.error.message);
                event.completed();
                return;
            }

            // Signal to the Outlook client that the event has been processed.
            console.log("Successfully set the subject.");
            event.completed();
        }
    );
}