Benutzereingaben in Dialogfelder
Über ein Dialogfeld werden in der Regel Benutzerdaten angefordert, die von der Anwendung benötigt werden. Diese Informationen werden von dem Formular verarbeitet, durch das das Dialogfeld angezeigt wird. Bei Verwendung eines Dialogfelds ist es wichtig, sein "Ergebnis" zu kennen, d. h., zu wissen, wie es geschlossen wird. Beispielsweise werden die vom Benutzer eingegebenen Daten durch Klicken auf die Schaltfläche Abbrechen verworfen und nicht gespeichert. Mithilfe der Form.DialogResult-Eigenschaft können Sie feststellen, auf welche Weise ein Dialogfeld geschlossen wurde.
Über den DialogResult-Eigenschaftswert des Formulars, durch das das Dialogfeld angezeigt wird (auch als übergeordnetes Formular des Dialogfelds geläufig) stellen Sie fest, ob auf die Schaltfläche OK oder Abbrechen geklickt wurde. Anschließend entscheiden Sie anhand des für DialogResult zurückgegebenen Werts, ob die Dialogfeldinformationen abgerufen werden müssen. Wenn keine Button-Steuerelemente im Dialogfeld verwendet werden, aber trotzdem ein DialogResult-Wert zurückgegeben werden soll, können Sie den Wert der DialogResult-Eigenschaft des Dialogfelds festlegen.
Wenn ein Formular als modales Dialogfeld angezeigt wird, wird das Formular ausgeblendet und für die DialogResult-Eigenschaft DialogResult.Cancel festgelegt, sobald Sie auf die Schaltfläche Schließen (die mit einem X gekennzeichnete Schaltfläche oben rechts im Formular) klicken. Die Close-Methode wird nicht automatisch aufgerufen, wenn der Benutzer auf die Schaltfläche Schließen eines Dialogfelds klickt oder den Wert der DialogResult-Eigenschaft festlegt. Das Formular wird nur ausgeblendet und kann ohne Erstellen einer neuen Instanz des Dialogsfelds erneut angezeigt werden. Aufgrund dieses Verhaltens müssen Sie die Dispose-Methode des Formulars aufrufen, wenn das Formular von der Anwendung nicht mehr benötigt wird.
Tipp
Der Wert, der der DialogResult-Eigenschaft zugewiesen wird, wenn der Benutzer auf die Schaltfläche Schließen klickt, kann überschrieben werden. Legen Sie dazu die DialogResult-Eigenschaft in einem Ereignishandler für das Closing-Ereignis des Formulars fest.
Siehe auch
Aufgaben
Gewusst wie: Erstellen von Dialogfeldern zur Entwurfszeit
Gewusst wie: Schließen von Dialogfeldern und Speichern von Benutzereingaben
Gewusst wie: Abrufen des Ergebnisses für Dialogfelder