Beispiel für dynamische Add-In-Steuerelemente in Word

Aktualisiert: Juli 2008

Hinweis:

Dieses Beispiel kann nur in Microsoft Office Word 2007 ausgeführt werden.

Wenn Sie zur Entwurfszeit noch nicht wissen, wie viele Steuerelemente zur Laufzeit in einem Dokument benötigt werden, können Sie als Reaktion auf bestimmte Ereignisse Steuerelemente dynamisch hinzufügen.

In diesem Beispiel wird gezeigt, wie Windows Forms-Steuerelemente und Hoststeuerelemente zur Laufzeit hinzugefügt und entfernt werden.

Sicherheitshinweis:

Dieser Beispielcode veranschaulicht ein Konzept und zeigt nur den Code an, der für dieses Konzept relevant ist. Der Code entspricht möglicherweise nicht den Sicherheitsanforderungen bestimmter Umgebungen und sollte daher nicht genau der Darstellung entsprechend verwendet werden. Es wird empfohlen, Sicherheits- und Fehlerbehandlungscode hinzuzufügen, um Projekte sicherer und robuster zu gestalten. Microsoft stellt diesen Beispielcode wie besehen und ohne Garantie zur Verfügung.

Informationen über das Installieren des Beispielprojekts auf dem Computer finden Sie unter Gewusst wie: Installieren und Verwenden von Beispieldateien in der Hilfe.

Download sample

So führen Sie dieses Beispiel aus

  1. Drücken Sie die Taste F5.

  2. Klicken Sie in das Dokument.

  3. Aktivieren Sie ein Kontrollkästchen im Aufgabenbereich.

    An der Cursorposition wird ein Steuerelement hinzugefügt.

  4. Deaktivieren Sie das Kontrollkästchen, das Sie aktiviert haben.

    Das Steuerelement wird aus dem Dokument entfernt.

Von Add-Ins erstellte Steuerelemente werden nicht automatisch in dem Dokument gespeichert. In diesem Beispiel werden die Steuerelementinformationen in einem benutzerdefinierten XML-Abschnitt gespeichert, damit die Steuerelemente in den Word-Instanzen erhalten bleiben.

So speichern Sie die Steuerelemente

  1. Drücken Sie die Taste F5.

  2. Klicken Sie in das Dokument.

  3. Aktivieren Sie ein Kontrollkästchen im Aufgabenbereich.

    An der Cursorposition wird ein Steuerelement hinzugefügt.

  4. Klicken Sie auf die Schaltfläche Speichern.

    Das Dialogfeld Steuerelemente löschen wird angezeigt.

  5. Klicken Sie auf Nein.

  6. Geben Sie im Dialogfeld Speichern unter einen Dateinamen für dieses Arbeitsblatt ein, und klicken Sie auf Speichern.

  7. Beenden Sie Word.

  8. Öffnen Sie die Datei, die Sie gerade gespeichert haben.

    Die Steuerelemente sind im Dokument immer noch vorhanden.

Veranschaulicht

  • Dynamisches Platzieren von Windows Forms-Steuerelementen und Hoststeuerelementen in einem Dokument.

  • Dynamisches Entfernen von Windows Forms-Steuerelementen und Hoststeuerelementen aus einem Dokument.

  • Speichern von Hoststeuerelementinformationen in einem XML-Abschnitt, der als Teil des Dokuments gespeichert wird.

Siehe auch

Aufgaben

Beispiel für dynamische Add-In-Steuerelemente in Excel

Konzepte

Übersicht über Hostelemente und Hoststeuerelemente

Aktionsbereichsübersicht

Weitere Ressourcen

Beispiele auf Dokumentebene

Beispiele auf Anwendungsebene

Steuerelemente für Office-Dokumente

Änderungsverlauf

Date

Versionsgeschichte

Grund

Juli 2008

Zusätzliches Thema

SP1-Featureänderung.