CancelEventArgs Klasa

Definicja

Udostępnia dane dla zdarzenia, które można anulować.

public ref class CancelEventArgs : EventArgs
public class CancelEventArgs : EventArgs
type CancelEventArgs = class
    inherit EventArgs
Public Class CancelEventArgs
Inherits EventArgs
Dziedziczenie
CancelEventArgs
Pochodne

Przykłady

W poniższym przykładzie użyto CancelEventArgs wartości i a CancelEventHandler do obsługi Closing zdarzenia .Form W tym kodzie przyjęto założenie, że utworzono Form zmienną o zmiennej na poziomie Boolean klasy o nazwie isDataSaved. Przyjęto również założenie, że dodano instrukcję , aby wywołać OtherInitialize metodę z metody formularza Load lub konstruktora (po wywołaniu metody ).InitializeComponent

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

Uwagi

Zdarzenie, które można anulować, jest wywoływane przez składnik, gdy ma on wykonać akcję, którą można anulować, na przykład Closing zdarzenie Form.

Uwaga

Zdarzenie Closing jest przestarzałe i zostało zastąpione przez FormClosing. Jest on oferowany jako przykład tylko w celu zilustrowania użycia elementu CancelEventArgs.

CancelEventArgs zawiera właściwość wskazującą Cancel , czy zdarzenie powinno zostać anulowane.

Konstruktory

CancelEventArgs()

Inicjuje CancelEventArgs nowe wystąpienie klasy z właściwością ustawioną Cancel na false.

CancelEventArgs(Boolean)

Inicjuje nowe wystąpienie CancelEventArgs klasy z właściwością Cancel ustawioną na daną wartość.

Właściwości

Cancel

Pobiera lub ustawia wartość wskazującą, czy zdarzenie powinno zostać anulowane.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy

Zobacz też