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

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

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokumentebene für Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

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.

Tipp

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:

-

Eine Version von Visual Studio 2010, die die Microsoft Office-Entwicklungstools einschließt. Weitere Informationen finden Sie unter [Konfigurieren eines Computers zum Entwickeln von Office-Lösungen](bb398242\(v=vs.100\).md).
  • Word 2007 oder Word 2010

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 Office-Projekten in Visual Studio.

    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.

    Tipp

    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

    Text einfügen

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! im 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 Office-Projekten.

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

Testen der Anwendung

Sie können das Dokument jetzt 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:

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