Freigeben über

Hinzufügen von Windows Forms-Steuerelementen zu Office-Dokumenten

  • Artikel

Sie können Microsoft Office Excel- und Microsoft Office Word-Dokumenten Windows Forms-Steuerelemente in Projekten auf Dokumentebene zur Entwurfszeit hinzufügen. Zur Laufzeit können Sie Steuerelemente in Anpassungen auf Dokumentebene und in VSTO-Add-Ins hinzufügen. Sie können z. B. ihrem Arbeitsblatt ein ComboBox Steuerelement hinzufügen, sodass Benutzer aus einer Liste mit Optionen auswählen können.

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

In diesem Thema werden die folgenden Aufgaben beschrieben:

Hinzufügen von Steuerelementen zur Entwurfszeit

Es gibt mehrere Möglichkeiten, dem Dokument Windows Forms-Steuerelemente in einem Projekt auf Dokumentebene zur Entwurfszeit hinzuzufügen.

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 der IDE.

So ziehen ein Windows Forms-Steuerelement auf das Dokument

  1. Erstellen oder öffnen Sie ein Excel-Arbeitsmappen- oder Word-Dokumentprojekt in Visual Studio, damit das Dokument im Designer angezeigt wird. Informationen zum Erstellen von Projekten finden Sie unter How to: Create Office projects in Visual Studio.

  2. Klicken Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox auf das Steuerelement, das Sie hinzufügen möchten, und ziehen Sie es in das Dokument.

    Hinweis

    Wenn Sie in Excel ein Steuerelement auswählen, wird =EMBED("WinForms.Control.Host","") in der Formelleisteangezeigt. Dieser Text ist erforderlich und sollte nicht gelöscht werden.

So ziehen ein Windows Forms-Steuerelement auf das Dokument

  1. Erstellen oder öffnen Sie ein Excel-Arbeitsmappen- oder Word-Dokumentprojekt in Visual Studio, damit das Dokument im Designer angezeigt wird. Informationen zum Erstellen von Projekten finden Sie unter How to: Create Office projects in Visual Studio.

  2. Klicken Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox auf das Steuerelement, das Sie hinzufügen möchten.

  3. Klicken Sie im Dokument auf die Stelle, an der die linke obere Ecke des Steuerelements positioniert werden soll, und ziehen Sie den Mauszeiger an die Stelle, an der sich die untere rechte Ecke des Steuerelements befinden soll.

    Das Steuerelement wird dem Dokument mit der angegebenen Größe und Position hinzugefügt.

    Hinweis

    Wenn Sie in Excel ein Steuerelement auswählen, wird =EMBED("WinForms.Control.Host","") in der Formelleisteangezeigt. Dieser Text ist erforderlich und sollte nicht gelöscht werden.

So fügen Sie dem Dokument ein Windows Forms-Steuerelement durch einfaches Klicken auf das Steuerelement hinzu

  1. Erstellen oder öffnen Sie ein Excel-Arbeitsmappen- oder Word-Dokumentprojekt in Visual Studio, damit das Dokument im Designer angezeigt wird. Informationen zum Erstellen von Projekten finden Sie unter How to: Create Office projects in Visual Studio.

  2. Klicken Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox auf das Steuerelement, das Sie hinzufügen möchten.

  3. Klicken Sie im Dokument auf die Stelle, an der das Steuerelement hinzugefügt werden soll.

    Das Steuerelement wird dem Dokument mit der Standardgröße hinzugefügt.

    Hinweis

    Wenn Sie in Excel ein Steuerelement auswählen, wird =EMBED("WinForms.Control.Host","") in der Formelleisteangezeigt. Dieser Text ist erforderlich und sollte nicht gelöscht werden.

So fügen Sie dem Dokument ein Windows Forms-Steuerelement durch Doppelklicken auf das Steuerelement hinzu

  1. Erstellen oder öffnen Sie ein Excel-Arbeitsmappen- oder Word-Dokumentprojekt in Visual Studio, damit das Dokument im Designer angezeigt wird. Informationen zum Erstellen von Projekten finden Sie unter How to: Create Office projects in Visual Studio.

  2. Doppelklicken Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox auf das Steuerelement, das Sie hinzufügen möchten.

    Das Steuerelement wird dem Dokument in der Mitte des Dokuments oder des aktiven Bereichs hinzugefügt.

    Hinweis

    Wenn Sie in Excel ein Steuerelement auswählen, wird =EMBED("WinForms.Control.Host","") in der Formelleisteangezeigt. Dieser Text ist erforderlich und sollte nicht gelöscht werden.

So fügen Sie dem Dokument ein Windows Forms-Steuerelement hinzu, indem Sie die EINGABETASTE drücken

  1. Erstellen oder öffnen Sie ein Excel-Arbeitsmappen- oder Word-Dokumentprojekt in Visual Studio, damit das Dokument im Designer angezeigt wird. Informationen zum Erstellen von Projekten finden Sie unter How to: Create Office Projects in Visual Studio.

  2. Klicken Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox auf das Steuerelement, das Sie hinzufügen möchten, und drücken Sie die EINGABETASTE .

    Das Steuerelement wird dem Dokument in der Mitte des Dokuments oder des aktiven Bereichs hinzugefügt.

    Hinweis

    Wenn Sie in Excel ein Steuerelement auswählen, wird =EMBED("WinForms.Control.Host","") in der Formelleisteangezeigt. Dieser Text ist erforderlich und sollte nicht gelöscht werden.

Hinzufügen von Steuerelementen zur Laufzeit in Projekten auf Dokumentebene

Sie können Windows Forms-Steuerelemente programmgesteuert zu einem Dokument zur Laufzeit hinzufügen. Verwenden Sie in Word die Methoden der Controls-Eigenschaft der ThisDocument-Klasse. Verwenden Sie in Excel Methoden der Controls Eigenschaft einer Sheetn-Klasse . Jede Methode verfügt über mehrere Überladungen, mit denen Sie die Position des Steuerelements auf unterschiedliche Weisen angeben können.

Wenn Sie einem Dokument zur Laufzeit ein Windows Forms-Steuerelement hinzufügen, wird das Steuerelement nicht im Dokument beibehalten, wenn das Dokument geschlossen wird. Sie können das Steuerelement beim nächsten Öffnen des Dokuments erneut erstellen. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

So fügen Sie zur Laufzeit ein Windows Forms-Steuerelement hinzu

  1. Verwenden Sie eine Methode mit dem Namen Add-Steuerelementklasse<> (wobei die Steuerelementklasse der Klassenname des Windows Forms-Steuerelements ist, das Sie hinzufügen möchten, zAddButton. B. ).

    Im folgenden Codebeispiel wird veranschaulicht, wie Sie einer Zelle C5 in einem Projekt auf Dokumentebene für Excel eine Button Zelle C5 Sheet1 hinzufügen.

    private void Sheet1_Startup(object sender, System.EventArgs e)
{
    Microsoft.Office.Tools.Excel.Controls.Button salesButton;
    salesButton = this.Controls.AddButton(this.get_Range("C5"), "salesButton");
    salesButton.Text = "Calculate Total Sales";
}

Hinzufügen von Steuerelementen zur Laufzeit in VSTO-Add-Ins

Sie können Windows Forms-Steuerelemente programmgesteuert zu jedem geöffneten Dokument zur Laufzeit hinzufügen. Generieren Sie zuerst ein Hostelement, das auf einem geöffneten Dokument oder Arbeitsblatt basiert. Verwenden Sie in Word die Methoden der Controls-Eigenschaft des neuen Hostelements. Verwenden Sie in Excel die Methoden der Controls-Eigenschaft des neuen Hostelements. Jede Methode verfügt über mehrere Überladungen, mit denen Sie die Position des Steuerelements auf unterschiedliche Weisen angeben können.

Wenn Sie einem Dokument zur Laufzeit ein Windows Forms-Steuerelement hinzufügen, wird das Steuerelement nicht im Dokument beibehalten, wenn das Dokument geschlossen wird. Sie können das Steuerelement beim nächsten Öffnen des Dokuments erneut erstellen. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Weitere Informationen zum Generieren von Hostelementen in VSTO-Add-In-Projekten finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in VSTO-Add-Ins zur Laufzeit.

So fügen Sie zur Laufzeit ein Windows Forms-Steuerelement hinzu

  1. Verwenden Sie eine Methode mit dem Namen Add-Steuerelementklasse<> (wobei die Steuerelementklasse der Klassenname des Windows Forms-Steuerelements ist, das Sie hinzufügen möchten, zAddButton. B. ).

    Hinweis

    In VSTO-Add-In-Projekten, die auf .NET Framework 4 oder höher abzielen, müssen Sie einen Verweis auf die Assembly "Microsoft.Office.Tools.Excel.v4.0.Utilities.dll" oder "Microsoft.Office.Tools.Word.v4.0.Utilities.dll" hinzufügen, bevor Sie auf die Methoden der Add-Steuerelementklasse>< zugreifen können.

    Das folgende Codebeispiel veranschaulicht das Hinzufügen von Button im ersten Absatz des aktiven Dokuments mithilfe eines Word-VSTO-Add-Ins.

    Microsoft.Office.Tools.Word.Controls.Button salesButton;

Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


extendedDocument.Paragraphs[1].Range.InsertParagraphBefore();
salesButton = extendedDocument.Controls.AddButton(
    extendedDocument.Paragraphs[1].Range, 75, 18, "salesButton");
salesButton.Text = "Calculate Sales";

Zugehöriger Inhalt