CancelEventArgs Classe

Definizione

Fornisce dati per un evento annullabile.

public ref class CancelEventArgs : EventArgs
public class CancelEventArgs : EventArgs
type CancelEventArgs = class
    inherit EventArgs
Public Class CancelEventArgs
Inherits EventArgs
Ereditarietà
CancelEventArgs
Derivato

Esempio

Nell'esempio seguente vengono utilizzati CancelEventArgs e un CancelEventHandler oggetto per gestire l'evento Closing di un oggetto Form. Questo codice presuppone che sia stato creato un Form oggetto con una variabile a livello Boolean di classe denominata isDataSaved. Presuppone inoltre che sia stata aggiunta un'istruzione per richiamare il OtherInitialize metodo dal metodo del Load modulo o dal costruttore (dopo la chiamata a 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

Commenti

Un evento annullabile viene generato da un componente quando sta per eseguire un'azione che può essere annullata, ad esempio l'evento Closing di un oggetto Form.

Nota

L'evento Closing è deprecato ed è stato sostituito da FormClosing. Viene offerto come esempio solo per illustrare l'utilizzo di CancelEventArgs.

CancelEventArgs fornisce la Cancel proprietà per indicare se l'evento deve essere annullato.

Costruttori

CancelEventArgs()

Consente di inizializzare una nuova istanza della classe CancelEventArgs con la proprietà Cancel impostata su false.

CancelEventArgs(Boolean)

Consente di inizializzare una nuova istanza della classe CancelEventArgs con la proprietà Cancelimpostata sul valore dato.

Proprietà

Cancel

Ottiene o imposta un valore che indica se l'evento debba essere annullato.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche