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

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 Excel 2007 Excel 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

Excel 2007
Excel 2003

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

Das ActionsPane-Objekt ist in Visual Studio Tools for Office-Projekten verfügbar. Es wird jedoch erst sichtbar, wenn Sie dem Objekt ein Windows Forms-Steuerelement hinzufügen.

Sie können einer Microsoft Office Excel-Arbeitsmappe einen Aktionsbereich hinzufügen, indem Sie ein Benutzersteuerelement erstellen und es dem Aktionsbereich hinzufügen. Das Dialogfeld Neues Element hinzufügen enthält ein Aktionsbereich-Steuerelement, das ein Benutzersteuerelement für den Aktionsbereich ist. Sie können dieses Steuerelement oder ein Benutzersteuerelement verwenden, das Ergebnis ist in beiden Fällen dasselbe.

Hinweis:
Sie können einen Aktionsbereich für Word oder Excel nur in einer Anpassung auf Dokumentebene 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:
Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Erstellen des Aktionsbereich-Steuerelements

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

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

Wenn das Aktionsbereich-Steuerelement im Designer nicht angezeigt wird, doppelklicken Sie im Projektmappen-Explorer auf HelloControl.
Ziehen Sie von der Registerkarte Windows Forms der Toolbox das Steuerelement Schaltfläche 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.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 Visual Studio Tools for Office.
```
public HelloControl()
{
    InitializeComponent();
    this.button1.Click += new System.EventHandler(this.button1_Click);
}
```

Hinzufügen des Aktionsbereich-Steuerelements zum Aktionsbereich

Fügen Sie Steuerelemente zum Aktionsbereich hinzu, um ihn anzuzeigen.

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

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