Anleitung: Code zur Bildbetrachter-App in Windows Forms (.NET Framework) hinzufügen

Artikel
02/03/2025

In dieser Reihe von drei Lernprogrammen erstellen Sie eine Windows Forms-Anwendung, die ein Bild lädt und anzeigt. Die Integrierte Entwurfsumgebung (Integrated Design Environment, IDE) von Visual Studio stellt die Tools bereit, die Sie zum Erstellen der App benötigen.

Steuerelemente verwenden C# oder Visual Basic-Code, um die ihnen zugeordneten Aktionen auszuführen.

In diesem dritten Lernprogramm erfahren Sie, wie Sie:

Hinzufügen von Ereignishandlern für Ihre Steuerelemente
Schreiben von Code zum Öffnen eines Dialogfelds
Schreiben von Code für die anderen Steuerelemente
Ausführen der Anwendung

Um eine neue Windows Forms-App mit .NET zu erstellen, folgen Sie dem Lernprogramm Erstellen einer Windows Forms-App mit .NET. Weitere Informationen finden Sie im Desktophandbuch für Windows Forms .NET-.

Voraussetzungen

Dieses Lernprogramm basiert auf den vorherigen Lernprogrammen Erstellen einer Bildanzeigeanwendung und Hinzufügen von UI-Steuerelementen zur Bildanzeige. Schließen Sie sie zuerst ab, und beginnen Sie mit dem Projekt, das Sie für diese Lernprogramme erstellt haben.

Hinzufügen von Ereignishandlern für Ihre Steuerelemente

Fügen Sie in diesem Abschnitt Ereignishandler für die Steuerelemente hinzu, die Sie im zweiten Lernprogramm hinzugefügt haben, Hinzufügen von Steuerelementen zu einer Bildanzeigeanwendung. Ihre Anwendung ruft einen Ereignishandler auf, wenn eine Aktion ausgeführt wird, z. B. das Auswählen einer Schaltfläche.

Öffnen Sie Visual Studio. Ihr Picture Viewer-Projekt wird unter Zuletzt verwendete Dateien öffnen angezeigt.
Doppelklicken Sie im Windows Forms Designer-auf die Schaltfläche Anzeigen eines Bildes. Sie können stattdessen im Formular die Schaltfläche Bild anzeigen auswählen und dann die EINGABETASTE drücken.

Die Visual Studio-IDE öffnet eine Registerkarte im Hauptfenster. Für C# wird die Registerkarte Form1.csbenannt. Wenn Sie Visual Basic verwenden, wird die Registerkarte Form1.vbbenannt.

Auf dieser Registerkarte wird die Codedatei hinter dem Formular angezeigt.

Anmerkung

Auf der Registerkarte „Form1.vb“ wird showButton möglicherweise als ShowButton angezeigt.

Konzentrieren Sie sich auf diesen Teil des Codes.

private void showButton_Click(object sender, EventArgs e)
{
}

Private Sub showButton_Click() Handles showButton.Click

End Sub

Klicken Sie erneut auf die Registerkarte Windows Forms-Designer, und doppelklicken Sie dann auf die schaltfläche Bild löschen, um den Code zu öffnen. Wiederholen Sie den Vorgang für die verbleibenden beiden Schaltflächen. Jedes Mal fügt die Visual Studio-IDE der Codedatei des Formulars eine neue Methode hinzu.

Doppelklicken Sie in Windows Forms Designer auf das CheckBox-Steuerelement, um eine checkBox1_CheckedChanged() Methode hinzuzufügen. Wenn Sie das Kontrollkästchen aktivieren oder deaktivieren, wird diese Methode aufgerufen.

Der folgende Codeausschnitt zeigt den neuen Code, den Sie im Code-Editor sehen.

private void clearButton_Click(object sender, EventArgs e)
{
}

private void backgroundButton_Click(object sender, EventArgs e)
{
}

private void closeButton_Click(object sender, EventArgs e)
{
}

private void checkBox1_CheckedChanged(object sender, EventArgs e)
{
}

Private Sub clearButton_Click() Handles clearButton.Click

End Sub

Private Sub backgroundButton_Click() Handles backgroundButton.Click

End Sub

Private Sub closeButton_Click() Handles closeButton.Click

End Sub

Private Sub CheckBox1_CheckedChanged() Handles CheckBox1.CheckedChanged

End Sub

Methoden, einschließlich Ereignishandlern, können einen beliebigen Namen haben. Wenn Sie einen Ereignishandler mit der IDE hinzufügen, wird ein Name basierend auf dem Namen des Steuerelements und dem behandelten Ereignis erstellt.

Beispielsweise wird das Click-Ereignis für eine Schaltfläche namens showButton showButton_Click() oder ShowButton_Click() genannt. Wenn Sie einen Codevariablennamen ändern möchten, klicken Sie im Code mit der rechten Maustaste auf die Variable, und wählen Sie dann Umgestalten>Umbenennenaus. Diese Aktion benennt alle Instanzen dieser Variablen im Code um. Weitere Informationen finden Sie unter Umbenennen durch Refactoring.

Schreiben von Code zum Öffnen eines Dialogfelds

Die Schaltfläche "Bild anzeigen" verwendet die OpenFileDialog-Komponente, um eine Bilddatei anzuzeigen. Diese Prozedur fügt den Code hinzu, der zum Aufrufen dieser Komponente verwendet wird.

Die Visual Studio-IDE bietet ein leistungsfähiges Tool namens IntelliSense-. Während der Eingabe schlägt IntelliSense möglichen Code vor.

Doppelklicken Sie in Windows Forms Designer-auf die Schaltfläche "Bild anzeigen". Die IDE verschiebt den Cursor innerhalb der showButton_Click()- oder ShowButton_Click()-Methode.
Geben Sie ein i in der leeren Zeile zwischen den beiden geschweiften Klammern { }oder zwischen Private Sub... und End Sub ein. Ein IntelliSense- Fenster wird geöffnet.
Das IntelliSense--Fenster sollte das Wort ifhervorheben. Wählen Sie die TAB-TASTE zweimal aus, um den if-Codeausschnitt einzufügen.
Wählen Sie true aus, und geben Sie dann op ein, um ihn für C# oder Op für Visual Basic zu überschreiben.

IntelliSense zeigt openFileDialog1an.
Wählen Sie Registerkarte aus, um openFileDialog1 hinzuzufügen.
Geben Sie (.) Punkt direkt nach openFileDialog1 ein. IntelliSense stellt alle Eigenschaften und Methoden der OpenFileDialog Komponente bereit. Beginnen Sie mit der Eingabe von ShowDialog, und wählen Sie Tab-aus. Die ShowDialog()-Methode zeigt das Dialogfeld "Datei öffnen" an.
Fügen Sie Klammern () unmittelbar nach dem "g" in ShowDialoghinzu. Ihr Code sollte openFileDialog1.ShowDialog()werden.
Fügen Sie für C# ein Leerzeichen hinzu, und fügen Sie dann zwei Gleichheitszeichen hinzu (==). Fügen Sie für Visual Basic ein Leerzeichen hinzu, und verwenden Sie dann ein einzelnes Gleichheitszeichen (=).
Fügen Sie ein weiteres Leerzeichen hinzu. Verwenden Sie IntelliSense, um DialogResult einzugeben.
Geben Sie einen Punkt ein, um den DialogResult-Wert im IntelliSense-Fenster zu öffnen. Geben Sie den Buchstaben O ein, und wählen Sie die TAB-TASTE aus, um OKeinzufügen.

Anmerkung

Die erste Codezeile sollte abgeschlossen sein. Für C# sollte dies etwa wie folgt aussehen.

if (openFileDialog1.ShowDialog() == DialogResult.OK)

Für Visual Basic sollte folgendes sein:

If OpenFileDialog1.ShowDialog() = DialogResult.OK Then

Fügen Sie die folgende Codezeile hinzu.

pictureBox1.Load(openFileDialog1.FileName);

PictureBox1.Load(OpenFileDialog1.FileName)

Sie können sie kopieren und einfügen oder IntelliSense verwenden, um sie hinzuzufügen. Die endgültige showButton_Click()-Methode sollte dem folgenden Code ähneln.

private void showButton_Click(object sender, EventArgs e)
{
    if (openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        pictureBox1.Load(openFileDialog1.FileName);  
    }
}

Private Sub showButton_Click() Handles showButton.Click
    If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
        PictureBox1.Load(OpenFileDialog1.FileName)
    End If

End Sub

Fügen Sie Ihrem Code den folgenden Kommentar hinzu.

private void showButton_Click(object sender, EventArgs e)
{
    // Show the Open File dialog. If the user clicks OK, load the
    // picture that the user chose.
    if (openFileDialog1.ShowDialog() == DialogResult.OK)
    {
        pictureBox1.Load(openFileDialog1.FileName);
    }
}

Private Sub showButton_Click() Handles showButton.Click

    ' Show the Open File dialog. If the user clicks OK, load the
    ' picture that the user chose.
    If OpenFileDialog1.ShowDialog() = DialogResult.OK Then
        PictureBox1.Load(OpenFileDialog1.FileName)
    End If

End Sub

Es ist die bewährte Methode, Ihren Code immer zu kommentieren. Mit Codekommentaren können Sie Ihren Code in Zukunft einfacher verstehen und verwalten.

Schreiben von Code für die anderen Steuerelemente

Wenn Sie Ihre Anwendung jetzt ausführen, können Sie Bild anzeigen auswählen. Bildanzeige öffnet das Dialogfeld "Datei öffnen", in dem Sie ein anzuzeigenes Bild auswählen können.

Fügen Sie in diesem Abschnitt den Code für die anderen Ereignishandler hinzu.

Doppelklicken Sie im Windows Forms Designerauf die Schaltfläche „Bild löschen“. Fügen Sie für C# den Code in geschweiften Klammern hinzu. Fügen Sie für Visual Basic den Code zwischen Private Sub und End Subhinzu.

private void clearButton_Click(object sender, EventArgs e)
{
    // Clear the picture.
    pictureBox1.Image = null;
}

Private Sub clearButton_Click() Handles clearButton.Click
    ' Clear the picture.
    PictureBox1.Image = Nothing
End Sub

Doppelklicken Sie auf die Schaltfläche Hintergrundfarbe festlegen, und fügen Sie den Code hinzu.

private void backgroundButton_Click(object sender, EventArgs e)
{
    // Show the color dialog box. If the user clicks OK, change the
    // PictureBox control's background to the color the user chose.
    if (colorDialog1.ShowDialog() == DialogResult.OK)
        pictureBox1.BackColor = colorDialog1.Color;
}

Private Sub backgroundButton_Click() Handles backgroundButton.Click
    ' Show the color dialog box. If the user clicks OK, change the
    ' PictureBox control's background to the color the user chose.
    If ColorDialog1.ShowDialog() = DialogResult.OK Then
        PictureBox1.BackColor = ColorDialog1.Color
    End If
End Sub

Doppelklicken Sie auf die Schaltfläche Schließen, und fügen Sie den Code hinzu.

private void closeButton_Click(object sender, EventArgs e)
{
    // Close the form.
    this.Close();
}

Private Sub closeButton_Click() Handles closeButton.Click
    ' Close the form.
    Close()
End Sub

Doppelklicken Sie auf das Kontrollkästchen Stretch, und fügen Sie den Code hinzu.

private void checkBox1_CheckedChanged(object sender, EventArgs e)
{
    // If the user selects the Stretch check box, 
    // change the PictureBox's
    // SizeMode property to "Stretch". If the user clears 
    // the check box, change it to "Normal".
    if (checkBox1.Checked)
        pictureBox1.SizeMode = PictureBoxSizeMode.StretchImage;
    else
        pictureBox1.SizeMode = PictureBoxSizeMode.Normal;
}

Private Sub CheckBox1_CheckedChanged() Handles CheckBox1.CheckedChanged
    ' If the user selects the Stretch check box, change 
    ' the PictureBox's SizeMode property to "Stretch". If the user 
    ' clears the check box, change it to "Normal".
    If CheckBox1.Checked Then
        PictureBox1.SizeMode = PictureBoxSizeMode.StretchImage
    Else
        PictureBox1.SizeMode = PictureBoxSizeMode.Normal
    End If
End Sub

Ausführen der Anwendung

Sie können Ihre Anwendung jederzeit ausführen, während Sie sie schreiben. Nachdem Sie den Code im vorherigen Abschnitt hinzugefügt haben, ist die Bildanzeige abgeschlossen. Verwenden Sie wie in den vorherigen Lernprogrammen eine der folgenden Methoden, um Ihre Anwendung auszuführen:

Wählen Sie die Taste F5 aus.
Wählen Sie in der Menüleiste Debuggen>Debuggen starten aus.
Wählen Sie auf der Symbolleiste die Schaltfläche Start aus.

Ein Fenster mit dem Titel Bildanzeige wird angezeigt. Testen Sie alle Steuerelemente.

Wählen Sie die Schaltfläche Hintergrundfarbe festlegen aus. Das Dialogfeld Farbe wird geöffnet.
Wählen Sie eine Farbe aus, um die Hintergrundfarbe festzulegen.
Wählen Sie Ein Bild anzeigen aus, um ein Bild anzuzeigen.
Aktivieren und deaktivieren Sie Dehnen.
Wählen Sie die Schaltfläche Bild löschen aus, um sicherzustellen, dass die Anzeige gelöscht wird.
Wählen Sie Schließen aus, um die App zu beenden.

Glückwunsch! Sie haben diese Reihe von Tutorials abgeschlossen. Sie haben diese Programmier- und Entwurfsaufgaben in der Visual Studio-IDE durchgeführt:

Erstellt ein Visual Studio-Projekt, das Windows Forms verwendet
Layout für die Bildanzeigeanwendung hinzugefügt
Hinzugefügte Schaltflächen und ein Kontrollkästchen
Dialogfelder hinzugefügt
Ereignishandler für Ihre Steuerelemente hinzugefügt
Geschriebener C#- oder Visual Basic-Code zum Behandeln der Ereignisse

Nächster Schritt

Lernen Sie mit einer weiteren Lernprogrammreihe weiter, wie Sie ein zeitlich geplantes mathematisches Quiz erstellen.

Lernprogramm 2: Erstellen eines zeitlichen mathematischen Quiz

Teilen über