Office.EventType enum

Gibt an, welche Art von Ereignis ausgelöst wurde. Wird von der type Eigenschaft eines *EventArgs Objekts zurückgegeben.

Add-Ins für Project unterstützen die Office.EventType.ResourceSelectionChangedEreignistypen , Office.EventType.TaskSelectionChanged, und Office.EventType.ViewSelectionChanged

Nur Aufgabenbereich-Add-Ins für Outlook unterstützen Postfach-API-Set-Ereignistypen.

Hinweise

Verwendet von

Beispiele

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

Felder

ActiveViewChanged

In PowerPoint wurde ein Document.ActiveViewChanged Ereignis ausgelöst.

AppointmentTimeChanged

Tritt auf, wenn ein beliebiges Datum oder eine Uhrzeit des ausgewählten Termins oder der ausgewählten Serie in Outlook geändert wird.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das AppointmentTimeChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.AppointmentTimeChangedEventArgs.

API-Satz: Mailbox 1.7

AttachmentsChanged

Tritt auf, wenn einem Element eine Anlage hinzugefügt oder von diesem entfernt wird.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das AttachmentsChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.AttachmentsChangedEventArgs.

API-Satz: Postfach 1.8

BindingDataChanged

Tritt auf, wenn Daten innerhalb der Bindung in Excel oder Word geändert werden.

Um einen Ereignishandler für das BindingDataChanged Ereignis einer Bindung hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Binding Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.BindingDataChangedEventArgs.

BindingSelectionChanged

Tritt auf, wenn die Auswahl innerhalb der Bindung in Excel oder Word geändert wird.

Um einen Ereignishandler für das BindingSelectionChanged Ereignis einer Bindung hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Binding Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.BindingSelectionChangedEventArgs.

DialogEventReceived

Tritt auf, wenn ein Dialog geschlossen wird oder wenn die Dialognavigation fehlschlägt.

Anleitungen zum Implementieren eines Dialogfelds in Ihrem Add-In finden Sie unter Verwenden der Office-Dialog-API in Office-Add-Ins.

DialogMessageReceived

Tritt auf, wenn ein Dialogfeld eine Nachricht mit Office.context.ui.messageParent.

Anleitungen zum Implementieren eines Dialogfelds in Ihrem Add-In finden Sie unter Verwenden der Office-Dialog-API in Office-Add-Ins.

DialogParentMessageReceived

Tritt auf, wenn eine Hostseite eine Nachricht an ein untergeordnetes Dialogfeld sendet mit Dialog.messageChild.

Anleitungen zum Implementieren eines Dialogfelds in Ihrem Add-In finden Sie unter Verwenden der Office-Dialog-API in Office-Add-Ins.

DocumentSelectionChanged

Tritt auf, wenn eine Auswahl auf Dokumentebene in Excel oder Word erfolgt.

DragAndDropEvent

Tritt in Outlook im Web und im neuen Outlook unter Windows auf, wenn Nachrichten oder Dateianlagen im Outlook-Clientfenster in den Aufgabenbereich eines Add-Ins gezogen und dann dort abgelegt werden.

Um einen Ereignishandler für das DragAndDropEvent Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Mailbox Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.DragAndDropEventArgs.

Wichtig: Das DragAndDropEvent Ereignis wird in Outlook unter Windows (klassisch) und auf Mac nicht unterstützt. Wenn der DragAndDropEvent Handler auf diesen Clients ausgeführt wird, tritt ein Fehler auf ("Dieses Ereignis wird auf dieser Plattform nicht unterstützt.").

API-Satz: Postfach 1.5

EnhancedLocationsChanged

Tritt auf, wenn der Terminort in Outlook geändert wird.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das EnhancedLocationsChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.EnhancedLocationsChangedEventArgs.

API-Satz: Postfach 1.8

InfobarClicked

Tritt in Outlook auf, wenn in einer Benachrichtigungsnachricht eine Aktion mit einer definierten benutzerdefinierten Aktion ausgewählt wird. Derzeit ist Schließen die einzige unterstützte Aktion, die dieses Ereignis auslöst.

Um einen Ereignishandler für das InfobarClicked Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.InfobarClickedEventArgs.

Wichtig:

  • Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

  • Obwohl Outlook für Mac diesen InsightMessage Benachrichtigungstyp unterstützt, unterstützt es das InfobarClicked Ereignis derzeit nicht. Um zu bestimmen, wann die Aktion "Verwerfen" aus der Benachrichtigung ausgewählt wird, implementieren Sie stattdessen einen Handler für das OnInfoBarDismissClicked Ereignis. Weitere Informationen finden Sie unter Aktivieren von Add-Ins mit Ereignissen.

API-Satz: Postfach 1.10

InitializationContextChanged

Tritt in Outlook auf, wenn der Aufgabenbereich eines Add-Ins über eine Aktionen erfordernde Nachricht, eine InsightMessage-Benachrichtigung , ein Dialogfeld "Intelligente Warnungen " oder ein integriertes Dialogfeld für die Spam-Berichterstellung geöffnet wird. Dieses Ereignis verhindert, dass ein Add-In neu gestartet wird, wenn dessen Aufgabenbereich bereits in Outlook geöffnet ist.

Wichtig: Das InitializationContextChanged Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das InitializationContextChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.InitializationContextChangedEventArgs.

API-Satz: Postfach 1.15

ItemChanged

Tritt auf, wenn ein anderes Outlook-Element zur Ansicht ausgewählt wird, während der Aufgabenbereich angeheftet ist.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das ItemChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Mailbox Objekts.

API-Satz: Postfach 1.5

NodeDeleted

Tritt auf, wenn ein customXmlPart Knoten gelöscht wird.

NodeInserted

Tritt auf, wenn ein customXmlPart Knoten eingefügt wird.

NodeReplaced

Tritt auf, wenn ein customXmlPart Knoten ausgetauscht wird.

OfficeThemeChanged

Tritt auf, wenn das OfficeTheme in Outlook geändert wird.

Um einen Ereignishandler für das OfficeThemeChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Mailbox Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.OfficeThemeChangedEventArgs.

Wichtig:

  • Das OfficeThemeChanged Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

  • Das OfficeThemeChanged Ereignis wird in Add-Ins, die eine ereignisbasierte Aktivierung implementieren, nicht unterstützt.

API-Satz: Postfach 1.14

RecipientsChanged

Tritt auf, wenn die Empfängerliste des ausgewählten Elements oder der Terminort in Outlook geändert wird.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das RecipientsChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.RecipientsChangedEventArgs.

API-Satz: Mailbox 1.7

RecurrenceChanged

Tritt auf, wenn das Serienmuster der ausgewählten Serie in Outlook geändert wird.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das RecurrenceChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.RecurrenceChangedEventArgs.

API-Satz: Mailbox 1.7

ResourceSelectionChanged

Tritt auf, wenn eine Ressourcenauswahl in Project erfolgt.

SelectedItemsChanged

Tritt in Outlook auf, wenn eine oder mehrere Nachrichten ausgewählt bzw. die Auswahl aufgehoben werden.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das SelectedItemsChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Mailbox Objekts.

API-Satz: Mailbox 1.13

SensitivityLabelChanged

Tritt in Outlook auf, wenn sich die Vertraulichkeitsbezeichnung einer Nachricht oder eines Termins ändert.

Wichtig: Dieses Ereignis kann nur in einem Aufgabenbereich behandelt werden. Funktionsbefehle können keinen Handler für dieses Ereignis registrieren.

Um einen Ereignishandler für das SensitivityLabelChanged Ereignis hinzuzufügen, verwenden Sie die addHandlerAsync Methode des Item Objekts. Der Ereignishandler empfängt ein Argument vom Typ Office.SensitivityLabelChangedEventArgs.

API-Satz: Mailbox 1.13

SettingsChanged

Ein Settings.settingsChanged Ereignis wurde in Excel, PowerPoint oder Word ausgelöst.

SpamReporting

Tritt in Outlook auf, wenn eine unerwünschte Nachricht gemeldet wird. Der Ereignishandler empfängt ein Argument vom Typ Office.SpamReportingEventArgs.

API-Satz: Postfach 1.14

TaskSelectionChanged

Tritt auf, wenn eine Vorgangsauswahl in Project erfolgt.

ViewSelectionChanged

Tritt auf, wenn eine Ansichtsauswahl in Project erfolgt.