Freigeben über

Inhalts-Office-Add-Ins

  • Artikel

Inhalts-Add-Ins sind Oberflächen, die direkt in Excel- oder PowerPoint-Dokumente eingebettet werden können. Inhalts-Add-Ins gewähren Benutzern Zugriff auf Benutzeroberflächen-Steuerelemente, die Code ausführen, um Dokumente zu ändern oder Daten aus einer Datenquelle anzuzeigen. Verwenden Sie Inhalts-Add-Ins, wenn Sie Funktionalität direkt in das Dokument einbetten möchten.

Abbildung 1: Typisches Layout für Inhalts-Add-Ins

Typisches Layout für Inhalts-Add-Ins in einer Office-Anwendung.

Bewährte Methoden

  • Fügen Sie oben in Ihrem Add-In einige Nagivations- oder Befehlselemente ein, z. B. CommandBar oder Pivot.
  • Schließen Sie am Ende des Add-Ins ein Branding-Element ein, z. B. BrandBar (gilt nur für Excel- und PowerPoint-Add-Ins).

Varianten

Inhalts-Add-In-Größen für Excel und PowerPoint in Office Desktop und in einem Webbrowser sind vom Benutzer angegeben.

Persönlichkeitsmenü

Persönlichkeitsmenüs können Nagivations- und Befehlselemente beeinträchtigen, die sich in der Nähe der rechten oberen Ecke des Add-Ins befinden. Nachfolgend finden Sie die aktuellen Abmessungen des Persönlichkeitsmenüs in Windows und Mac.

Für Windows misst das Persönlichkeitsmenü 12 x 32 Pixel, wie dargestellt.

Abbildung 2: Persönlichkeitsmenü unter Windows

Persönlichkeitsmenü mit 12 x 32 Pixeln auf Dem Windows-Desktop.

Für Mac misst das Persönlichkeitsmenü 26 x 26 Pixel, fließt jedoch 8 Pixel von rechts und 6 Pixel von oben nach innen, wodurch sich der beanspruchte Platz auf 34 x 32 erhöht, wie dargestellt.

Abbildung 3: Persönlichkeitsmenü auf dem Mac

Persönlichkeitsmenü mit 34 x 32 Pixeln auf dem Mac-Desktop.

Implementierung

Es gibt geringfügige Unterschiede in den Manifesten zwischen Inhalts-Add-Ins und Add-Ins, die Aufgabenbereiche verwenden. Öffnen Sie die Registerkarte für den Typ des verwendeten Manifests.

Hinweis

Das einheitliche Manifest ist in Excel, PowerPoint und Word als Entwicklervorschau verfügbar. Für Outlook ist es allgemein verfügbar und kann in Produktions-Add-Ins verwendet werden.

Konfigurieren Sie das Manifest mit den folgenden Schritten.

  1. Fügen Sie dem Erweiterungsobjekt im Array "extensions" ein untergeordnetes Array "contentRuntimes" hinzu.
  2. Entfernen Sie die Eigenschaft "runtimes", sofern sie vorhanden ist. Das Array "runtimes" ist für Aufgabenbereich- oder E-Mail-Add-Ins vorgesehen. Diese können nicht mit einem Inhalts-Add-In kombiniert werden.
  3. Fügen Sie dem Array "contentRuntimes" ein anonymes Inhaltslaufzeitobjekt hinzu.
  4. Legen Sie die Eigenschaft "id" des Objekts auf einen beschreibenden Namen fest.
  5. Legen Sie das Objekt "code.page" auf die vollständige URL des benutzerdefinierten Inhalts fest, den Sie in das Dokument einbetten möchten.
  6. Legen Sie optional die Eigenschaften "requestedWidth" und "requestedHeight" auf eine Größe zwischen 32 und 1000 Pixel fest. Wenn diese Eigenschaften nicht verwendet werden, bestimmt die Office-Anwendung die Größe.
  7. Legen Sie optional die Eigenschaft "disableSnapshot" auf festtrue, um zu verhindern, dass Office eine Momentaufnahme der Inhaltskomponente mit dem Dokument speichert.

Es folgt ein Beispiel für eine "contentRuntimes"-Eigenschaft.

"contentRuntimes": [
    {
        "id": "ContentRuntime",
        "code": {
            "page": "https://localhost:3000/content.html"
        },
        "requestedWidth": 100,
        "requestedHeight": 100,
        "disableSnapshot": true,
    }
]

Ein Beispiel, das ein Inhalts-Add-In implementiert, finden Sie unter Excel-Inhalts-Add-In Humongous Insurance auf GitHub.

Informationen zum Erstellen eines eigenen Inhalts-Add-Ins finden Sie in den Schnellstartanleitungen zum Excel-Inhalts-Add-In und zum PowerPoint-Inhalts-Add-In.

Supportüberlegungen

  • Überprüfen Sie, ob Ihr Office-Add-In auf einer bestimmten Office-Anwendung oder -Plattform funktioniert.
  • Bei einigen Inhalts-Add-Ins müssen Benutzer möglicherweise das Add-In als vertrauenswürdig festlegen, um in Excel oder PowerPoint zu lesen und zu schreiben. Sie können deklarieren, welche Berechtigungsebene Ihre Benutzer im Add-In-Manifest benötigen.

Siehe auch