Office.BeforeDocumentCloseNotification interface
Stellt ein modales Benachrichtigungsdialogfeld dar, das angezeigt werden kann, wenn der Benutzer versucht, ein Dokument zu schließen. Das Dokument wird erst geschlossen, wenn der Benutzer antwortet. Im Benachrichtigungsdialogfeld kann der Benutzer die Anforderung zum Schließen des Dokuments bestätigen oder die Anforderung zum Schließen des Dokuments abbrechen. Diese API wird nur in Excel unterstützt.
Hinweise
Anforderungssatz: SharedRuntime 1.2
Beispiele
// Enable the before document close modal notification dialog.
async function enableNotification() {
await Office.addin.beforeDocumentCloseNotification.enable();
}
// Add an event handler to detect when the document close operation is cancelled.
Office.addin.beforeDocumentCloseNotification.onCloseActionCancelled(async function () {
// When the document close attempt is cancelled, write a message to the active range in the worksheet.
await Excel.run(async (context) => {
const range = context.workbook.getSelectedRange();
range.values = [["Detected onCloseActionCancelled event."]];
await context.sync();
});
});
Methoden
disable() | Verhindert, dass das Benachrichtigungsdialogfeld angezeigt wird, wenn der Benutzer versucht, ein Dokument zu schließen. Die |
enable() | Aktivieren Sie ein modales Benachrichtigungsdialogfeld, das angezeigt wird, wenn der Benutzer versucht, ein Dokument zu schließen. Das Dokument wird erst geschlossen, wenn der Benutzer antwortet. In diesem Benachrichtigungsdialogfeld wird der Benutzer aufgefordert, die Anforderung zum Schließen des Dokuments zu bestätigen, oder der Benutzer kann die Anforderung zum Schließen des Dokuments abbrechen. Die |
on |
Fügt einen Ereignishandler hinzu, der erkennt, wenn der
Die |
Details zur Methode
disable()
Verhindert, dass das Benachrichtigungsdialogfeld angezeigt wird, wenn der Benutzer versucht, ein Dokument zu schließen. Die BeforeDocumentCloseNotification
API wird nur in Excel unterstützt.
disable(): Promise<void>;
Gibt zurück
Promise<void>
Hinweise
Anforderungssatz: SharedRuntime 1.2
enable()
Aktivieren Sie ein modales Benachrichtigungsdialogfeld, das angezeigt wird, wenn der Benutzer versucht, ein Dokument zu schließen. Das Dokument wird erst geschlossen, wenn der Benutzer antwortet. In diesem Benachrichtigungsdialogfeld wird der Benutzer aufgefordert, die Anforderung zum Schließen des Dokuments zu bestätigen, oder der Benutzer kann die Anforderung zum Schließen des Dokuments abbrechen. Die BeforeDocumentCloseNotification
API wird nur in Excel unterstützt.
enable(): Promise<void>;
Gibt zurück
Promise<void>
Hinweise
Anforderungssatz: SharedRuntime 1.2
onCloseActionCancelled(handler)
Fügt einen Ereignishandler hinzu, der erkennt, wenn der BeforeDocumentCloseNotification
Schließvorgang abgebrochen wird. Dieser Ereignishandler wird ausgelöst, wenn die beiden folgenden Bedingungen erfüllt sind.
Das Add-In ruft die
enable
-Methode für dasBeforeDocumentCloseNotification
-Objekt auf.Wenn das Benachrichtigungsdialogfeld geöffnet ist, klickt der Endbenutzer im Dialogfeld auf die Schaltfläche Nicht schließen , klickt auf die Schaltfläche Schließen in der oberen rechten Ecke des Dialogfelds oder drückt die ESC-TASTE.
Die BeforeDocumentCloseNotification
API wird nur in Excel unterstützt.
onCloseActionCancelled(
handler: () => void
): Promise<() => Promise<void>>;
Parameter
- handler
-
() => void
Der Ereignishandler, der aufgerufen wird, wenn der Dialog abgebrochen wird.
Gibt zurück
Promise<() => Promise<void>>
Eine Zusage, die aufgelöst wird, wenn der Ereignishandler hinzugefügt wird.
Hinweise
Anforderungssatz: SharedRuntime 1.2
Office Add-ins