Freigeben über


Office.AddinCommands.Event interface

Das Event -Objekt wird als Parameter an Add-In-Funktionen übergeben, die von Funktionsbefehlsschaltflächen aufgerufen werden. Mit dem -Objekt kann das Add-In erkennen, auf welche Schaltfläche geklickt wurde, und der Office-Anwendung signalisieren, dass die Verarbeitung abgeschlossen wurde.

Hinweise

Informationen zur Unterstützung in Excel, Word und PowerPoint finden Sie unter Anforderungssätze für Add-In-Befehle.

Im Folgenden werden Supportinformationen für Outlook beschrieben.

[ API-Satz: Postfach 1.3 ]

Weitere Supportinformationen finden Sie unter Anforderungssätze für Add-In-Befehle .

Mindestberechtigungsstufe (Outlook): eingeschränkt

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Eigenschaften

source

Informationen zum Steuerelement, das den Aufruf dieser Funktion ausgelöst hat.

Methoden

completed(options)

Gibt an, dass die Verarbeitung des Add-Ins abgeschlossen wurde und automatisch geschlossen wird.

Diese Methode muss am Ende einer Funktion aufgerufen werden, die wie folgt aufgerufen wurde:

  • Eine Funktionsbefehlsschaltfläche (d. b. ein Add-In-Befehl, der mit einem <Action-Element> definiert ist, wobei das xsi:type Attribut auf ExecuteFunctionfestgelegt ist).

  • Ein Ereignis , das im Erweiterungspunkt Ereignisse eines On-Send-Add-Ins in Outlook definiert ist. Beispiel: ein ItemSend Ereignis.

Details zur Eigenschaft

source

Informationen zum Steuerelement, das den Aufruf dieser Funktion ausgelöst hat.

source:Source;

Eigenschaftswert

Hinweise

Im Folgenden werden Supportinformationen für Outlook beschrieben.

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Beispiele

// In this example, consider a button defined in an add-in manifest.
// The following is the XML manifest definition. Below it is the Teams 
// manifest (preview) definition.
//
//<Control xsi:type="Button" id="eventTestButton">
//    <Label resid="eventButtonLabel" />
//    <Tooltip resid="eventButtonTooltip" />
//    <Supertip>
//        <Title resid="eventSuperTipTitle" />
//        <Description resid="eventSuperTipDescription" />
//    </Supertip>
//    <Icon>
//        <bt:Image size="16" resid="blue-icon-16" />
//        <bt:Image size="32" resid="blue-icon-32" />
//        <bt:Image size="80" resid="blue-icon-80" />
//    </Icon>
//    <Action xsi:type="ExecuteFunction">
//        <FunctionName>testEventObject</FunctionName>
//    </Action>
//</Control>
//
// The Teams manifest (preview) definition is the following.
// Ellipses("...") indicate omitted properties.
//
//     "extensions": [
//         {
//             ...
//             "runtimes": [
//                 {
//                  "id": "CommandsRuntime",
//                  "type": "general",
//                  "code": {
//                      "page": "https://localhost:3000/commands.html",
//                      "script": "https://localhost:3000/commands.js"
//                  },
//                  "lifetime": "short",
//                  "actions": [
//                      {
//                          "id": "testEventObject",
//                          "type": "executeFunction",
//                          "displayName": "testEventObject"
//                      }
//                  ]
//              }
//             ],
//             "ribbons": [
//                 {
//                     ...
//                     "tabs": [
//                         ...
//                         "groups": [
//                             ...
//                             "controls": [
//                                 {
//                                      "id": "eventTestButton",
//                                      "type": "button",
//                                      "label": "Perform an action",
//                                      "icons": [
//                                          {
//                                              "size": 16,
//                                              "file": "https://localhost:3000/assets/blue-icon-16.png"
//                                          },
//                                          {
//                                              "size": 32,
//                                              "file": "https://localhost:3000/assets/blue-icon-32.png"
//                                          },
//                                          {
//                                              "size": 80,
//                                              "file": "https://localhost:3000/assets/blue-icon-80.png"
//                                          }
//                                      ],
//                                      "supertip": {
//                                          "title": "Perform an action",
//                                          "description": "Perform an action when clicked."
//                                      },
//                                      "actionId": "testEventObject"
//                                  }
//                             ]
//                         ]
//                     ]                           
//                 }
//             ]
//         }
//     ]



// The button has an id set to "eventTestButton", and will invoke
// the testEventObject function defined in the add-in.
// That function looks like this:
function testEventObject(event) {
    // The event object implements the Event interface.

    // This value will be "eventTestButton".
    const buttonId = event.source.id;

    // Signal to the host app that processing is complete.
    event.completed();
}
// Function is used by two buttons:
// button1 and button2
function multiButton (event) {
    // Check which button was clicked.
    const buttonId = event.source.id;

    if (buttonId === 'button1') {
        doButton1Action();
    } else {
        doButton2Action();
    }

    event.completed();
}

Details zur Methode

completed(options)

Gibt an, dass die Verarbeitung des Add-Ins abgeschlossen wurde und automatisch geschlossen wird.

Diese Methode muss am Ende einer Funktion aufgerufen werden, die wie folgt aufgerufen wurde:

  • Eine Funktionsbefehlsschaltfläche (d. b. ein Add-In-Befehl, der mit einem <Action-Element> definiert ist, wobei das xsi:type Attribut auf ExecuteFunctionfestgelegt ist).

  • Ein Ereignis , das im Erweiterungspunkt Ereignisse eines On-Send-Add-Ins in Outlook definiert ist. Beispiel: ein ItemSend Ereignis.

completed(options?: EventCompletedOptions): void;

Parameter

options
Office.AddinCommands.EventCompletedOptions

Optional. Ein -Objekt, das das Verhalten eines On-Send-Add-Ins in Outlook angibt, wenn es die Verarbeitung eines ItemSend Ereignisses abgeschlossen hat.

Gibt zurück

void

Hinweise

Im Folgenden werden Supportinformationen für Outlook beschrieben.

[ API-Satz: Postfach 1.3 ]

Mindestberechtigungsstufe: eingeschränkt

Anwendbarer Outlook-Modus: Verfassen oder Lesen

Wichtig: Der options Parameter gilt nur für Outlook-Add-Ins, die das On-Send-Feature implementieren. Es wurde in Mailbox 1.8 eingeführt.

Beispiele

// For the following example, the processItem function is
// defined in the FunctionFile referenced from the add-in manifest,
// and maps to the FunctionName of the action in the associated button control.
function processItem(event) {
    // Do some processing.

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