Office.EventType enum

発生したイベントの種類を指定します。 *EventArgs オブジェクトの type プロパティによって返されます。

Project 用アドインは、 Office.EventType.ResourceSelectionChangedOffice.EventType.TaskSelectionChanged、および Office.EventType.ViewSelectionChanged のイベントの種類をサポートしています。

Outlook の作業ウィンドウ アドインのみがメールボックス API セットのイベントの種類をサポートしています。

注釈

使用元

// This sample shows how to register an event handler in Outlook.
Office.onReady(() => {
    // Registers an event handler to identify when messages are selected.
    Office.context.mailbox.addHandlerAsync(Office.EventType.SelectedItemsChanged, getMessageProperties, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(asyncResult.error.message);
            return;
        }

        console.log("Event handler added for the SelectedItemsChanged event.");
    });
});

function getMessageProperties() {
    // Retrieves the selected messages' properties and logs them to the console.
    Office.context.mailbox.getSelectedItemsAsync((asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(asyncResult.error.message);
            return;
        }

        asyncResult.value.forEach((message) => {
            console.log(`Item ID: ${message.itemId}`);
            console.log(`Subject: ${message.subject}`);
            console.log(`Item type: ${message.itemType}`);
            console.log(`Item mode: ${message.itemMode}`);
        });
    });
}

フィールド

ActiveViewChanged

PowerPoint 年に Document.ActiveViewChanged イベントが発生しました。

AppointmentTimeChanged

選択した予定または系列の任意の日付または時刻が Outlook で変更されたときに発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

AppointmentTimeChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、Office.AppointmentTimeChangedEventArgs 型の引数を受け取ります。

API セット: メールボックス 1.7

AttachmentsChanged

アイテムに添付ファイルが追加または削除されたときに発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

AttachmentsChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.AttachmentsChangedEventArgs 型の引数を受け取ります。

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

BindingDataChanged

Excel または Word でバインド内のデータが変更されたときに発生します。

バインドの BindingDataChanged イベントのイベント ハンドラーを追加するには、Binding オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.BindingDataChangedEventArgs 型の引数を受け取ります。

BindingSelectionChanged

Excel または Word のバインド内で選択が変更されたときに発生します。

バインドの BindingSelectionChanged イベントのイベント ハンドラーを追加するには、Binding オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.BindingSelectionChangedEventArgs 型の引数を受け取ります。

DialogEventReceived

ダイアログが閉じられたとき、またはダイアログ ナビゲーションが失敗した場合に発生します。

アドインにダイアログを実装する方法の詳細については、「 Office アドインで Office ダイアログ API を使用する」を参照してください。

DialogMessageReceived

ダイアログが Office.context.ui.messageParent を使用してメッセージを送信するときに発生します。

アドインにダイアログを実装する方法の詳細については、「 Office アドインで Office ダイアログ API を使用する」を参照してください。

DialogParentMessageReceived

ホスト ページが Dialog.messageChild を使用して子ダイアログ ボックスにメッセージを送信するときに発生します。

アドインにダイアログを実装する方法の詳細については、「 Office アドインで Office ダイアログ API を使用する」を参照してください。

DocumentSelectionChanged

Excel または Word で文書レベルの選択が行われたときに発生します。

DragAndDropEvent

これは、Outlook on the web および新しい Outlook on Windows で、Outlook クライアント ウィンドウでアドインの作業ウィンドウにメッセージまたは添付ファイルをドラッグしてからドロップすると発生します。

DragAndDropEvent イベントのイベント ハンドラーを追加するには、Mailbox オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、Office.DragAndDropEventArgs 型の引数を受け取ります。

重要: DragAndDropEvent イベントは、Outlook on Windows (クラシック) および Outlook Macではサポートされていません。 これらのクライアントで DragAndDropEvent ハンドラーを実行すると、エラーが発生します ("このイベントはこのプラットフォームではサポートされていません。")。

API セット: メールボックス 1.5

EnhancedLocationsChanged

Outlook で予定の場所が変更されたときに発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

EnhancedLocationsChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.EnhancedLocationsChangedEventArgs 型の引数を受け取ります。

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

InfobarClicked

定義済みのカスタム アクションが設定された通知メッセージでアクションが選択されると、Outlook で実行。 現在、このイベントを発生させるサポートされているアクションは "無視 " のみです。

InfobarClicked イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、Office.InfobarClickedEventArgs 型の引数を受け取ります。

重要:

  • このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

  • Mac 上の Outlook は InsightMessage 通知の種類をサポートしていますが、現在 InfobarClicked イベントをサポートしていません。 通知から [ 却下 ] アクションが選択されたタイミングを確認するには、代わりに OnInfoBarDismissClicked イベントのハンドラーを実装します。 詳細については、「イベントを使用してアドインをアクティブ化する」を参照してください。

API セット: メールボックス 1.10

InitializationContextChanged

アクション可能なメッセージInsightMessage 通知、スマート アラート ダイアログ、または統合されたスパム報告ダイアログからアドインの作業ウィンドウを開いたときに Outlook で発生します。 このイベントは、アドインの作業ウィンドウが既に Outlook で開いている場合、アドインを再起動できないようにします。

重要: InitializationContextChanged イベントは作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

InitializationContextChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.InitializationContextChangedEventArgs 型の引数を受け取ります。

API セット: メールボックス 1.15

ItemChanged

作業ウィンドウが固定されているときに、別の Outlook アイテムが選択されて表示されている場合に発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

ItemChanged イベントのイベント ハンドラーを追加するには、Mailbox オブジェクトの addHandlerAsync メソッドを使用します。

API セット: メールボックス 1.5

NodeDeleted

customXmlPart ノードが削除されたときに発生します。

NodeInserted

customXmlPart ノードが挿入されたときに発生します。

NodeReplaced

customXmlPart ノードが置き換えられたときに発生します。

OfficeThemeChanged

Outlook で OfficeTheme が変更されたときに発生します。

OfficeThemeChanged イベントのイベント ハンドラーを追加するには、Mailbox オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、Office.OfficeThemeChangedEventArgs 型の引数を受け取ります。

重要:

  • OfficeThemeChanged イベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

  • OfficeThemeChanged イベントは、イベントベースのアクティブ化を実装するアドインではサポートされていません

API セット: メールボックス 1.14

RecipientsChanged

Outlook で選択したアイテムの受信者リストまたは予定の場所が変更されたときに発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

RecipientsChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.RecipientsChangedEventArgs 型の引数を受け取ります。

API セット: メールボックス 1.7

RecurrenceChanged

Outlook で選択した系列の定期的なパターンが変更されたときに発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

RecurrenceChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.RecurrenceChangedEventArgs 型の引数を受け取ります。

API セット: メールボックス 1.7

ResourceSelectionChanged

Project でリソースの選択が行われたときに発生します。

SelectedItemsChanged

1 つ以上のメッセージが選択または選択解除されたときに Outlook で発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

SelectedItemsChanged イベントのイベント ハンドラーを追加するには、Mailbox オブジェクトの addHandlerAsync メソッドを使用します。

API セット: メールボックス 1.13

SensitivityLabelChanged

メッセージまたは予定の秘密度ラベルが変更されたときに Outlook で発生します。

重要: このイベントは、作業ウィンドウでのみ処理できます。 関数コマンドは、このイベントのハンドラーを登録できません。

SensitivityLabelChanged イベントのイベント ハンドラーを追加するには、Item オブジェクトの addHandlerAsync メソッドを使用します。 イベント ハンドラーは、 Office.SensitivityLabelChangedEventArgs 型の引数を受け取ります。

API セット: メールボックス 1.13

SettingsChanged

Excel、PowerPoint、または Word でSettings.settingsChangedイベントが発生しました。

SpamReporting

一方的でないメッセージが報告されたときに Outlook で発生します。 イベント ハンドラーは、 Office.SpamReportingEventArgs 型の引数を受け取ります。

API セット: メールボックス 1.14

TaskSelectionChanged

Project でタスクの選択が行われたときに発生します。

ViewSelectionChanged

Project でビューの選択が行われたときに発生します。