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

  • Artikel

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:

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