CancelEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
- 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 |
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) |