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 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 |
| 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) |