Compartilhar via


Office.MailboxEvent interface

O MailboxEvent objeto é passado como um argumento para o manipulador de eventos de um suplemento que implementa a ativação baseada em eventos, incluindo Alertas Inteligentes ou o recurso de relatório de spam integrado. Ele permite que o suplemento se conecte ao cliente do Outlook que concluiu o processamento de um evento.

Comentários

[ Conjunto de API: Caixa de correio 1.10 ]

Nível mínimo de permissão: restrito

Modo outlook aplicável: compor ou ler

Importante: o suporte para o recurso integrado de relatório de spam foi introduzido na Caixa de Correio 1.14.

Métodos

completed()

Indica que o suplemento baseado em eventos ou de relatório de spam concluiu o processamento de um evento.

Detalhes do método

completed()

Indica que o suplemento baseado em eventos ou de relatório de spam concluiu o processamento de um evento.

completed(): void;

Retornos

void

Comentários

[ Conjunto de API: Caixa de correio 1.10 ]

Nível mínimo de permissão: restrito

Modo outlook aplicável: compor ou ler

Importante:

  • O suporte para o recurso integrado de relatório de spam foi introduzido na Caixa de Correio 1.14.

  • O suporte para atribuir um SmartAlertsEventCompletedOptions objeto ao options parâmetro foi introduzido na Caixa de Correio 1.12.

Exemplos

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