Freigeben über


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 beschrieben.

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

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

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

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

    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.

Voraussetzungen

Zum Abschließen dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

Erstellen des Projekts

Im ersten Schritt wird ein Word-Dokumentprojekt erstellt.

So erstellen Sie ein neues Projekt

  1. Erstellen Sie ein Word-Dokumentprojekt mit dem Namen "Meine Word-Schaltfläche". Wählen Sie im Assistenten " Neues Dokument erstellen" aus.

    Weitere Informationen finden Sie unter How to: Create Office projects in Visual Studio.

    Visual Studio öffnet das neue Word-Dokument im Designer und fügt das Projekt "Meine Word-Schaltfläche" zu Projektmappen-Explorer hinzu.

Hinzufügen von Steuerelementen zum Word-Dokument

Die Steuerelemente der Benutzeroberfläche umfassen eine Schaltfläche und ein Textfeld für das Word-Dokument.

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

  1. Stellen Sie sicher, dass das Dokument im Visual Studio-Designer geöffnet ist.

  2. Ziehen Sie auf der Registerkarte "Allgemeine Steuerelemente " der Toolbox ein TextBox Steuerelement in das Dokument.

    Hinweis

    In Word werden Steuerelemente standardmäßig in einer Reihe mit Text abgelegt. Sie können die Art und Weise ändern, wie Steuerelemente und Shape-Objekte eingefügt werden, indem Sie die Standardeinstellung auf der Registerkarte "Bearbeiten " des Dialogfelds "Optionen " in Word ändern.

  3. Klicken Sie im Menü Ansicht auf Eigenschaftenfenster.

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

  5. Ziehen Sie ein Schaltflächen-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 beim Klicken auf die Schaltfläche ausgeführt wird.

Auffüllen des Textfelds, wenn auf die Schaltfläche geklickt wird

Jedes Mal, wenn der Benutzer die Schaltfläche auswählt, wird Hallo Welt! zum Textfeld hinzugefügt.

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

  1. Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf ThisDocument, und wählen Sie dann im Kontextmenü "Code anzeigen" aus.

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

    private void insertText_Click(object sender, EventArgs e)
    {
        this.displayText.Text += "Hello World!";
    }
    
  3. In C# müssen Sie dem Startup-Ereignis einen Ereignishandler für die Schaltfläche hinzufügen. Informationen zum Erstellen von Ereignishandlern finden Sie unter How to: Create event handlers in Office projects.

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

Testen der App

Sie können nun Ihr Dokument testen, um sicherzustellen, dass die Nachricht Hallo Welt! im Textfeld angezeigt wird, wenn Sie die Schaltfläche auswählen.

So testen Sie das Dokument

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

  2. Wählen Sie die Schaltfläche aus.

  3. Vergewissern Sie sich, dass Hallo Welt! im Textfeld angezeigt wird.

Nächste Schritte

Diese exemplarische Vorgehensweise veranschaulicht die Grundlagen der Verwendung von Schaltflächen und Textfeldern in Word-Dokumenten. Die folgenden Aufgaben könnten sich daran anschließen: