CancelEventArgs Klasse

Definition

Stellt Daten für ein abbrechbares Ereignis bereit.

public ref class CancelEventArgs : EventArgs
public class CancelEventArgs : EventArgs
type CancelEventArgs = class
    inherit EventArgs
Public Class CancelEventArgs
Inherits EventArgs
Vererbung
CancelEventArgs
Abgeleitet

Beispiele

Im folgenden Beispiel wird CancelEventArgs und ein CancelEventHandler verwendet, um das Closing Ereignis eines Formzu behandeln. In diesem Code wird davon ausgegangen, dass Sie eine Form mit einer Variablen auf Klassenebene Boolean mit dem Namen isDataSavederstellt haben. Außerdem wird davon ausgegangen, dass Sie eine -Anweisung hinzugefügt haben, um die OtherInitialize -Methode aus der -Methode oder dem Konstruktor des Formulars Load aufzurufen (nach dem Aufruf InitializeComponentvon ).

private:
   // Call this method from the InitializeComponent() method of your form
   void OtherInitialize()
   {
      this->Closing += gcnew CancelEventHandler( this, &Form1::Form1_Cancel );
      this->myDataIsSaved = true;
   }

   void Form1_Cancel( Object^ /*sender*/, CancelEventArgs^ e )
   {
      if ( !myDataIsSaved )
      {
         e->Cancel = true;
         MessageBox::Show( "You must save first." );
      }
      else
      {
         e->Cancel = false;
         MessageBox::Show( "Goodbye." );
      }
   }
// Call this method from the constructor of your form
    private void OtherInitialize() {
       this.Closing += new CancelEventHandler(this.Form1_Closing);
       // Exchange commented line and note the difference.
       this.isDataSaved = true;
       //this.isDataSaved = false;
    }

    private void Form1_Closing(Object sender, CancelEventArgs e) {
       if (!isDataSaved) {
          e.Cancel = true;
          MessageBox.Show("You must save first.");
       }
       else {
          e.Cancel = false;
          MessageBox.Show("Goodbye.");
       }
    }
' Call this method from the Load method of your form.
Private Sub OtherInitialize()
    ' Exchange commented line and note the difference.
    Me.isDataSaved = True
    'Me.isDataSaved = False
End Sub

Private Sub Form1_Closing(sender As Object, e As _
   System.ComponentModel.CancelEventArgs) Handles MyBase.Closing
    If Not isDataSaved Then
        e.Cancel = True
        MessageBox.Show("You must save first.")
    Else
        e.Cancel = False
        MessageBox.Show("Goodbye.")
    End If
End Sub

Hinweise

Ein abbruchbares Ereignis wird von einer Komponente ausgelöst, wenn eine Aktion ausgeführt werden soll, die abgebrochen werden kann, z. B. das Closing Ereignis eines Form.

Hinweis

Das Closing Ereignis ist veraltet und wurde durch FormClosingersetzt. Es wird hier als Beispiel nur angeboten, um die Verwendung von CancelEventArgszu veranschaulichen.

CancelEventArgs stellt die Cancel -Eigenschaft bereit, um anzugeben, ob das Ereignis abgebrochen werden soll.

Konstruktoren

CancelEventArgs()

Initialisiert eine neue Instanz der CancelEventArgs-Klasse, wobei die Cancel-Eigenschaft auf false festgelegt ist.

CancelEventArgs(Boolean)

Initialisiert eine neue Instanz der CancelEventArgs-Klasse, wobei die Cancel-Eigenschaft auf den angegebenen Wert festgelegt ist.

Eigenschaften

Cancel

Ruft einen Wert ab, der angibt, ob das Ereignis abgebrochen werden soll, oder legt diesen fest.

Methoden

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen