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

Artikel
08/10/2011

Um einem Microsoft Office Word-Dokument einen Aktionsbereich hinzuzufügen, erstellen Sie zuerst ein Windows Forms-Benutzersteuerelement. Fügen Sie anschließend der Controls-Eigenschaft des ThisDocument.ActionsPane-Felds im Projekt das Benutzersteuerelement hinzu.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Tipp

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

Erstellen des Benutzersteuerelements

Im folgenden Verfahren wird beschrieben, wie ein Benutzersteuerelement in einem Word-Projekt erstellt wird. Außerdem wird dem Benutzersteuerelement eine Schaltfläche hinzugefügt, das Text in das Dokument schreibt, wenn darauf geklickt wird.

So erstellen Sie das Benutzersteuerelement

Ö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.

Tipp

Sie können dem Projekt alternativ ein Benutzersteuerelement hinzufügen. Die vom Aktionsbereich-Steuerelement generierten Klassen und Benutzersteuerelemente sind funktional äquivalent.
Ziehen Sie von der Registerkarte Windows Forms der Toolbox ein Button-Steuerelement auf das Steuerelement.

Tipp

Wenn das Steuerelement im Designer nicht angezeigt wird, doppelklicken Sie im Projektmappen-Explorer auf HelloControl.

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 Office-Projekten.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new EventHandler(this.button1_Click);
}
```

Hinzufügen des Benutzersteuerelements zum Aktionsbereich

Um den Aktionsbereich anzuzeigen, fügen Sie der Controls-Eigenschaft des ThisDocument.ActionsPane-Felds das Benutzersteuerelement hinzu.

So fügen Sie dem Aktionsbereich das Benutzersteuerelement hinzu

Fügen Sie der ThisDocument-Klasse als Deklaration auf Klassenebene den folgenden Code hinzu (fügen Sie diesen Code nicht zu einer Methode hinzu).
```
Dim hello As New HelloControl
```
```
private HelloControl hello = new HelloControl();
```
Fügen Sie dem ThisDocument_Startup-Ereignishandler der ThisDocument-Klasse folgenden Code hinzu:
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```