Office.AddinCommands.EventCompletedOptions interface

パッケージ:

office

ItemSend イベントの処理が完了したときの Outlook での送信時アドインの動作を指定します。

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル: 制限あり

適用される Outlook モード: Compose

プロパティ

allowEvent

完了したメソッドを使用してイベント ハンドラーの完了を通知する場合、この値は、処理されたイベントが実行を続行するか、取り消されるかを示します。 たとえば、 ItemSend イベントを処理する送信時アドインは、 allowEvent を false に設定してメッセージの送信を取り消すことができます。

プロパティの詳細

allowEvent

完了したメソッドを使用してイベント ハンドラーの完了を通知する場合、この値は、処理されたイベントが実行を続行するか、取り消されるかを示します。 たとえば、 ItemSend イベントを処理する送信時アドインは、 allowEvent を false に設定してメッセージの送信を取り消すことができます。

allowEvent: boolean;

プロパティ値

boolean

注釈

[ API セット: メールボックス 1.8 ]

最小アクセス許可レベル (Outlook): 制限付き

適用される Outlook モード: Compose

例

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