Office.AddinCommands.EventCompletedOptions interface

When you use the completed method to signal completion of an event handler, this value indicates if the handled event should continue execution or be canceled. For example, an on-send add-in that handles the ItemSend event can set allowEvent to false to cancel the sending of a message.

allowEvent: boolean;

Property Value

Remarks

[ API set: Mailbox 1.8 ]

Minimum permission level (Outlook): restricted

Applicable Outlook mode: Compose

Examples

// In this example, the checkMessage function was registered as an event handler for ItemSend.
function checkMessage(event) {
    // Get the item being sent.
    const outgoingMsg = Office.context.mailbox.item;

    // Check if subject contains "BLOCK".
    outgoingMsg.subject.getAsync(function (result) {
        // Subject is in `result.value`.
        // If search term "BLOCK" is found, don't send the message.
        const notFound = -1;
        const allowEvent = (result.value.indexOf('BLOCK') === notFound);
        event.completed({ allowEvent: allowEvent });
    });
}