CancelEventArgs Classe

Definizione

Fornisce dati per un evento annullabile.Provides data for a cancelable event.

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

Esempi

Nell'esempio seguente vengono CancelEventArgs usati e CancelEventHandler un oggetto per Closing gestire l'evento Formdi un oggetto.The following example uses CancelEventArgs and a CancelEventHandler to handle the Closing event of a Form. Questo codice presuppone che sia stato creato un Form con una variabile a livello Boolean di classe isDataSaveddenominata.This code assumes that you have created a Form with a class-level Boolean variable named isDataSaved. Si presuppone inoltre che sia stata aggiunta un'istruzione per richiamare il OtherInitialize metodo dal Load metodo del form o dal costruttore, dopo la chiamata a InitializeComponent.It also assumes that you have added a statement to invoke the OtherInitialize method from the form's Load method or the constructor (after the call to 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 Closing l'evento di Formun oggetto.A cancelable event is raised by a component when it is about to perform an action that can be canceled, such as the Closing event of a Form.

Nota

L' Closing evento è deprecato ed è stato sostituito da FormClosing.The Closing event is deprecated and has been replaced by FormClosing. Viene offerto come esempio solo per illustrare l'utilizzo di CancelEventArgs.It is offered as an example here only to illustrate the usage of CancelEventArgs.

CancelEventArgsfornisce la Cancel proprietà per indicare se l'evento deve essere annullato.CancelEventArgs provides the Cancel property to indicate whether the event should be canceled.

Costruttori

CancelEventArgs()

Consente di inizializzare una nuova istanza della classe CancelEventArgs con la proprietà Cancel impostata su false.Initializes a new instance of the CancelEventArgs class with the Cancel property set to false.

CancelEventArgs(Boolean)

Consente di inizializzare una nuova istanza della classe CancelEventArgs con la proprietà Cancelimpostata sul valore dato.Initializes a new instance of the CancelEventArgs class with the Cancel property set to the given value.

Proprietà

Cancel

Ottiene o imposta un valore che indica se l'evento debba essere annullato.Gets or sets a value indicating whether the event should be canceled.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche