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

Artikel
08/10/2011

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

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Excel 2007 und Excel 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.

Link zu Video Eine Videodemonstration zu diesem Thema finden Sie unter How Do I: Use WPF Controls Inside an Excel Actions Pane?.

Erstellen des Benutzersteuerelements

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

So erstellen Sie das Benutzersteuerelement

Öffnen Sie die Excel-Arbeitsmappe 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 ein 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.Sheet1.Range("A1").Value2 = "Hello world!"
End Sub

private void button1_Click(object sender, System.EventArgs e)
{
    Globals.Sheet1.Range["A1", System.Type.Missing].Value2 = "Hello World!";
}

In C# müssen Sie einen Ereignishandler für Button erstellen. Sie können diesen Code im HelloControl-Konstruktor einfügen. Weitere Informationen zum Erstellen von Ereignishandlern finden Sie unter Gewusst wie: Erstellen von Ereignishandlern in Office-Projekten.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.EventHandler(this.button1_Click);
}
```

Hinzufügen des Benutzersteuerelements zum Aktionsbereich

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

So fügen Sie dem Aktionsbereich das Benutzersteuerelement hinzu

Fügen Sie der ThisWorkbook-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 ThisWorkbook_Startup-Ereignishandler der ThisWorkbook-Klasse folgenden Code hinzu:
```
Me.ActionsPane.Controls.Add(hello)
```
```
this.ActionsPane.Controls.Add(hello);
```