Share via

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

  • Artikel

Wenn Sie einem Microsoft Office Word-Dokument oder einer Microsoft Excel-Arbeitsmappe einen Aktionsbereich hinzufügen möchten, erstellen Sie zuerst ein Windows Forms-Benutzersteuerelement. Fügen Sie dann das Benutzersteuerelement zur Controls Eigenschaft des Felds ThisDocument.ActionsPane (Word) oder ThisWorkbook.ActionsPane Felds (Excel) in Ihrem Projekt hinzu.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene für Excel und Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

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. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Personalisieren von Visual Studio-IDE.

Erstellen des Benutzersteuerelements

Das folgende Verfahren zeigt, wie Sie benutzersteuerelemente in einem Word- oder Excel-Projekt erstellen. Außerdem wird dem Benutzersteuerelement eine Schaltfläche hinzugefügt, die Text in das Dokument oder die Arbeitsmappe schreibt, wenn darauf geklickt wird.

So erstellen Sie das Benutzersteuerelement

  1. Öffnen Sie Ihr Word- oder Excel-Projekt auf Dokumentebene in Visual Studio.

  2. Klicken Sie im Menü Projekt auf Neues Element hinzufügen.

  3. Wählen Sie im Dialogfeld "Neues Element hinzufügen" "Aktionsbereich-Steuerelement" aus, nennen Sie es "HelloControl", und klicken Sie auf "Hinzufügen".

    Hinweis

    Alternativ können Sie ihrem Projekt ein Benutzersteuerungselement hinzufügen. Die klassen, die von den Elementen "Actions Pane Control " und "User Control " generiert werden, sind funktionell gleichwertig.

  4. Ziehen Sie auf der Registerkarte "Windows Forms " der Toolbox ein Schaltflächen-Steuerelement auf das Steuerelement.

    Hinweis

    Wenn das Steuerelement im Designer nicht sichtbar ist, doppelklicken Sie in Projektmappen-Explorer auf HelloControl.

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

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

  6. In C# müssen Sie einen Ereignishandler für den Klick auf die Schaltfläche hinzufügen. Sie können diesen Code im HelloControl Konstruktor nach dem Aufruf von InitializeComponent.

    Informationen zum Erstellen von Ereignishandlern finden Sie unter How to: Create Event Handlers in Office Projects.

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

So fügen Sie das Benutzersteuerelement zum Aktionsbereich hinzu

  1. Fügen Sie der Klasse ThisWorkbook den ThisDocument folgenden Code als Deklaration auf Klassenebene hinzu (fügen Sie diesen Code keiner Methode hinzu).

    private HelloControl hello = new HelloControl();

  2. Fügen Sie dem Ereignishandler der ThisDocument Klasse oder dem Ereignishandler der ThisWorkbook Klasse den ThisWorkbook_StartupThisDocument_Startup folgenden Code hinzu.

    this.ActionsPane.Controls.Add(hello);

Zugehöriger Inhalt