Ereignis Office.initialize (JavaScript-API für Office)

apps for Office

Tritt ein, wenn die Laufzeitumgebung geladen wurde und die App bereit ist für die Interaktion mit der Anwendung und dem gehosteten Dokument.

Letzte Änderung: Montag, 22. Juni 2015

Note Hinweis

"Apps für Office" heißen in Zukunft "Office-Add-Ins". In der Übergangsphase kann in der Dokumentation und in der Benutzeroberfläche möglicherweise immer noch der Begriff "Apps für Office" verwendet werden.

Hosts:

Access, Excel, Outlook, PowerPoint, Project, Word

Zuletzt geändert in

1.1

Alle Supportdetails anzeigen

Office.initialize = function (reason) {/* initialization code */}

Der reason-Parameter der Listenerfunktion für das initialize-Ereignis gibt einen InitializationReason-Aufzählungswert zurück, der angibt, wie die Initialisierung erfolgt ist. Es gibt zwei Möglichkeiten zum Initialisieren einer Aufgabenbereich- oder Inhalts-App:

  • Der Benutzer hat sie soeben über den Abschnitt Zuletzt verwendete Appsin der Dropdownliste App auf der Registerkarte Einfügen des Menübands in der Office-Hostanwendung oder über das Dialogfeld App einfügen eingefügt.

  • Der Benutzer hat ein Dokument geöffnet, das die App bereits enthält.

Hinweis Hinweis

Der "reason"-Parameter der Listenerfunktion für das initialize-Ereignis gibt nur einen InitializationReason-Aufzählungswert für Aufgabenbereich- und Inhalts-Apps zurück. Für Mail-Apps wird kein Wert zurückgegeben.

Sie können mit dem Wert der InitializationEnumeration unterschiedliche Logik abhängig davon zurückgeben, wann die App erstmalig eingefügt wurde oder ob sie bereits Teil des Dokuments ist. Im folgenden Beispiel wird eine einfache Logik dargestellt, in der mit dem Wert des reason-Parameters angezeigt wird, wie die Aufgabenbereich- oder Inhalts-App initialisiert wurde.

Office.initialize = function (reason) {
    // Checks for the DOM to load using the jQuery ready function.
    $(document).ready(function () {
    // After the DOM is loaded, app-specific code can run.
    // Display initialization reason.
    if (reason == "inserted")
    write("The app was just inserted.");

    if (reason == "documentOpened")
    write("The app is already part of the document.");
    });
}

// Function that writes to a div with id='message' on the page.
function write(message){
    document.getElementById('message').innerText += message; 
}

Ein Häkchen (V) in der folgenden Matrix weist darauf hin, dass dieses Ereignis in der entsprechenden Office-Hostanwendung unterstützt wird. Eine leere Zelle weist darauf hin, dass die Office-Hostanwendung dieses Ereignis nicht unterstützt.

Weitere Informationen zu den Voraussetzungen der Office-Hostanwendung und des Servers finden Sie unter Anforderungen zum Ausführen von Apps für Office.

Office für Windows Desktop

Office Online
(im Browser)

Office für iPad

OWA für mobile Geräte

Outlook für Mac

Access

v

Excel

v

v

v

Outlook

v

v

v

v

PowerPoint

v

Project

v

Word

v

v

Mindestberechtigungsstufe

Eingeschränkt

App-Typen

Inhalt, Mail, Aufgabenbereich

Bibliothek

Office.js

Namespace

Office

Version

Änderungen

1.1

Erweiterte Unterstützung für Excel in Office für iPad

1.1

Unterstützung für die Initialisierung von Inhalts-Apps für Access hinzugefügt.

1.0

Eingeführt

Anzeigen:
© 2015 Microsoft