Gewusst wie: Hinzufügen eines Aktionsbereichs zu Word-Dokumenten

Artikel
04/28/2010

Aktualisiert: November 2007

Betrifft
Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office. Projekttyp Projekte auf Dokumentebene Microsoft Office-Version Word 2007 Word 2003 Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Die Informationen in diesem Thema gelten nur für die angegebenen Projekte und Versionen von Visual Studio Tools for Office von Microsoft Office.

Projekttyp

Projekte auf Dokumentebene

Microsoft Office-Version

Word 2007
Word 2003

Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Das Dialogfeld Neues Element hinzufügen enthält ein Aktionsbereich-Steuerelement, bei dem es sich um ein Benutzersteuerelement für den Aktionsbereich handelt. Die Verwendung eines Aktionsbereich-Steuerelements oder eines Benutzersteuerelements führt zu demselben Ergebnis.

Informationen zum Hinzufügen eines Aktionsbereichs in einer Microsoft Office Excel-Arbeitsmappe finden Sie unter Gewusst wie: Hinzufügen eines Aktionsbereichs zu Excel-Arbeitsmappen.

Hinweis:
Sie können einen Aktionsbereich nur in einer Anpassung auf Dokumentebene für Word oder Excel erstellen. In einem Add-In auf Anwendungsebene können Sie keinen Aktionsbereich erstellen. Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Hinweis:
Auf Ihrem Computer werden möglicherweise andere Namen oder Speicherorte für die Benutzeroberflächenelemente von Visual Studio, die in den folgenden Anweisungen aufgeführt sind, angezeigt. Die von Ihnen verwendete Visual Studio-Edition und die Einstellungen legen diese Elemente fest. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Erstellen des Aktionsbereich-Steuerelements

So erstellen Sie ein Aktionsbereich-Steuerelement und fügen Text im Dokument ein

Öffnen Sie das Word-Dokument oder das Vorlagenprojekt in Visual Studio.
Klicken Sie im Menü Projekt auf Neues Element hinzufügen.
Klicken Sie im Dialogfeld Neues Element hinzufügen auf Aktionsbereich-Steuerelement, nennen Sie es HelloControl, und klicken Sie auf Hinzufügen.
Wenn das Aktionsbereich-Steuerelement im Designer nicht angezeigt wird, doppelklicken Sie auf HelloControl im Designer.
Ziehen Sie das Steuerelement Schaltfläche von der Registerkarte Windows Forms der Toolbox zum Aktionsbereich-Steuerelement.

Fügen Sie dem Click-Ereignishandler der Schaltfläche folgenden Code hinzu.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles Button1.Click

    Globals.ThisDocument.Paragraphs(1).Range.Text = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.ThisDocument.Paragraphs[1].Range.Text = "Hello World!";
}

In C# müssen Sie einen Ereignishandler für Klickereignisse auf Schaltflächen hinzufügen. Sie können diesen Code nach dem Aufruf von IntializeComponent in den HelloControl-Konstruktor einfügen.

Informationen zum Erstellen von Ereignishandlern finden Sie unter Gewusst wie: Erstellen von Ereignishandlern in Visual Studio Tools for Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

Hinzufügen des Aktionsbereich-Steuerelements zum Aktionsbereich

Um den Aktionsbereich anzuzeigen, fügen Sie ihm ein Steuerelement hinzu. Im folgenden Beispiel wird dem Aktionsbereich ein Aktionsbereich-Steuerelement in Word hinzugefügt.

So fügen Sie dem Aktionsbereich ein Aktionsbereich-Steuerelement hinzu

Erstellen Sie in der ThisDocument-Klasse eine neue Instanz des Aktionsbereich-Steuerelements.
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Fügen Sie dem Startup-Ereignishandler von ThisDocument den folgenden Code hinzu.
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```