Exemplarische Vorgehensweise: Anzeigen von Text in einem Textfeld in einem Dokument mithilfe einer Schaltfläche

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 Word 2007 Word 2003 Weitere Informationen finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

In dieser exemplarischen Vorgehensweise wird die Verwendung von Schaltflächen und Textfeldern in einer Anpassung auf Dokumentebene für Microsoft Office Word veranschaulicht.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

• Hinzufügen von Steuerelementen zum Word-Dokument in einem Projekt auf Dokumentebene zur Entwurfszeit.

• Füllen eines Textfelds beim Klicken auf eine Schaltfläche.

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.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

• Visual Studio Tools for Office (eine optionale Komponente von Visual Studio 2008 Professional und Visual Studio Team System).

• Microsoft Office Word 2003 oder Microsoft Office Word 2007.

Erstellen des Projekts

Der erste Schritt besteht darin, ein Word-Dokumentprojekt zu erstellen.

So erstellen Sie ein neues Projekt

• Erstellen Sie ein Word-Dokumentprojekt mit dem Namen My Word Button. Wählen Sie im Assistenten Neues Dokument erstellen aus.

  Weitere Informationen finden Sie unter Gewusst wie: Erstellen von Visual Studio Tools for Office-Projekte.

  Visual Studio öffnet das neue Word-Dokument im Designer und fügt dem Projektmappen-Explorer das My Word Button-Projekt hinzu.

Hinzufügen von Steuerelementen zum Word-Dokument

Die Benutzeroberflächensteuerelemente bestehen aus einer Schaltfläche und einem Textfeld im Word-Dokument.

So fügen Sie eine Schaltfläche und ein Textfeld hinzu

1. Überprüfen Sie, ob das Dokument im Visual Studio-Designer geöffnet ist.

2. Ziehen Sie von der Registerkarte Allgemeine Steuerelemente der Toolbox ein TextBox-Steuerelement in das Dokument.

   Hinweis:
   In Word werden Steuerelemente standardmäßig inline mit Text abgelegt. Sie können die Art und Weise ändern, wie Steuerelemente und Formobjekte eingefügt werden, indem Sie in Word im Dialogfeld Optionen auf der Registerkarte Bearbeiten die Standardeinstellung ändern.

3. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

4. Suchen Sie TextBox1 im Dropdownfeld des Eigenschaftenfensters, und ändern Sie die Name-Eigenschaft des Textfelds in displayText.

5. Ziehen Sie ein Button-Steuerelement in das Dokument, und ändern Sie die folgenden Eigenschaften.

   Eigenschaft	Wert
   Name	insertText
   Text	Insert Text

Jetzt können Sie den Code schreiben, der ausgeführt wird, wenn auf die Schaltfläche geklickt wird.

Füllen des Textfelds beim Klicken auf die Schaltfläche

Jedes Mal, wenn der Benutzer auf die Schaltfläche klickt, wird Hello World! dem Textfeld hinzugefügt.

So schreiben Sie beim Klicken auf die Schaltfläche in das Textfeld

1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument, und klicken Sie dann im Kontextmenü auf Code anzeigen.

2. Fügen Sie dem Click-Ereignishandler der Schaltfläche folgenden Code hinzu.

   Private Sub insertText_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles insertText.Click
   
       Me.displayText.Text += "Hello World!"
   End Sub
   

   private void insertText_Click(object sender, EventArgs e)
   {
       this.displayText.Text += "Hello World!";
   }
   

3. In C# müssen Sie für die Schaltfläche einen Ereignishandler zum Startup-Ereignis hinzufügen. Weitere Informationen zum Erstellen von Ereignishandlern finden Sie unter Gewusst wie: Erstellen von Ereignishandlern in Visual Studio Tools for Office.

   this.insertText.Click += new EventHandler(insertText_Click);
   

Testen der Anwendung

Sie können nun das Dokument testen, um sicherzustellen, dass die Meldung Hello World! im Textfeld angezeigt wird, wenn Sie auf die Schaltfläche klicken.

So testen Sie das Dokument

1. Drücken Sie F5, um das Projekt auszuführen.

2. Klicken Sie auf die Schaltfläche.

3. Überprüfen Sie, ob im Textfeld Hello World! angezeigt wird.

Nächste Schritte

In dieser exemplarischen Vorgehensweise werden die Grundlagen für die Verwendung von Schaltflächen und Textfeldern in Word-Dokumenten beschrieben. Die folgenden Aufgaben könnten sich daran anschließen:

• Verwenden eines Kombinationsfelds zum Ändern der Formatierung. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Ändern der Dokumentformatierung mit CheckBox-Steuerelementen.

• Verwenden von Optionsfeldern, um Diagrammstile auszuwählen. Weitere Informationen hierzu finden Sie unter Exemplarische Vorgehensweise: Aktualisieren eines Diagramms in einem Dokument mithilfe von Optionsfeldern.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von Windows Forms-Steuerelementen zu Office-Dokumenten

Konzepte

Übersicht über Windows Forms-Steuerelemente in Office-Dokumenten

Exemplarische Vorgehensweisen in Word

Übersicht über Hostelemente und Hoststeuerelemente

Weitere Ressourcen

Beispiele und exemplarische Vorgehensweisen für die Programmierung mit Office