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.
Mindestberechtigungsstufe (Outlook): eingeschränkt
Anwendbarer Outlook-Modus: Compose 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:
|
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.
Mindestberechtigungsstufe: eingeschränkt
Anwendbarer Outlook-Modus: Compose 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 .
Ein On-Send-Add-In in Outlook.
Ein Onlinebesprechungsanbieter-Add-In in Outlook.
Ein Notizprotokollierungs-Add-In in Outlook auf mobilen Geräten.
completed(options?: EventCompletedOptions): void;Parameter
Optional. In Outlook ein -Objekt, das das Verhalten eines On-Send-Add-Ins, eines Anbieter-Add-Ins für Onlinebesprechungen oder eines mobilen Notizprotokollierungs-Add-Ins angibt, wenn es die Verarbeitung eines Ereignisses abgeschlossen hat.
Gibt zurück
void
Hinweise
Im Folgenden werden Supportinformationen für Outlook beschrieben.
Mindestberechtigungsstufe: eingeschränkt
Anwendbarer Outlook-Modus: Compose oder Lesen
Wichtig:
Der
optionsParameter gilt nur für Outlook-Add-Ins. Es wurde in Mailbox 1.8 eingeführt. Obwohl Outlook unter Android und unter iOS bis zu Postfach 1.5 unterstützt, wird deroptionsParameter in Mobilen Add-Ins für Onlinebesprechungen und Notizprotokollierung unterstützt. Weitere Informationen zur API-Unterstützung in Outlook auf mobilen Geräten finden Sie unter Outlook JavaScript-APIs, die in Outlook auf mobilen Geräten unterstützt werden.Ereignisbasierte Aktivierung und integrierte Spamberichts-Add-Ins verwenden ein anderes Ereignisobjekt, um zu signalisieren, wenn sie die Verarbeitung eines Ereignisses abgeschlossen haben. Weitere Informationen finden Sie unter Office.MailboxEvent.
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 });
});
}