Condividi tramite


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 viene CancelEventArgs utilizzato 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. Si presuppone inoltre che sia stata aggiunta un'istruzione per richiamare il OtherInitialize metodo dal metodo del Load form 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
void OtherInitialize()
{
    Closing += Form1_Closing;
    // Exchange commented line and note the difference.
    isDataSaved = true;
    //this.isDataSaved = false;
}

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.

Annotazioni

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

Nome Descrizione
CancelEventArgs()

Inizializza una nuova istanza della CancelEventArgs classe con la Cancel proprietà impostata su false.

CancelEventArgs(Boolean)

Inizializza una nuova istanza della CancelEventArgs classe con la Cancel proprietà impostata sul valore specificato.

Proprietà

Nome Descrizione
Cancel

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

Metodi

Nome Descrizione
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 il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche