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

Artikel
02/26/2013

Um Aktionsbereich einem Microsoft Office Word-Dokument oder eine Microsoft Excel-Arbeitsmappe hinzuzufügen, erstellen Sie zuerst ein Windows Forms-Benutzersteuerelement.Fügen Sie dann das Benutzersteuerelement der Controls-Eigenschaft des ThisDocument.ActionsPane Felds (Word) oder des ThisWorkbook.ActionsPane Felds (Excel) im Projekt hinzu.

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

Hinweis
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 Visual Studio-Einstellungen.

Erstellen des Benutzersteuerelements

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

So erstellen Sie das Benutzersteuerelement

Öffnen Sie das Projekt für Word oder Excel auf Dokumentebene 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.

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

Hinweis

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

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

Fügen Sie den Code Click dem - Ereignishandler der Schaltfläche hinzu.Das folgende Beispiel zeigt Code für ein Microsoft Office Word-Dokument.

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 das Benutzersteuerelement der Controls-Eigenschaft des ThisDocument.ActionsPane Felds (Word) oder des Felds ThisWorkbook.ActionsPane hinzu (Excel).

So fügen Sie dem Aktionsbereich das Benutzersteuerelement hinzu

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