CancelEventArgs Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje data pro událost, která se dá zrušit.
public ref class CancelEventArgs : EventArgs
public class CancelEventArgs : EventArgs
type CancelEventArgs = class
inherit EventArgs
Public Class CancelEventArgs
Inherits EventArgs
- Dědičnost
- Odvozené
Příklady
Následující příklad používá CancelEventArgs a a CancelEventHandler pro zpracování Closing události Form. Tento kód předpokládá, že jste vytvořili proměnnou Form na úrovni Boolean třídy s názvem isDataSaved. Předpokládá se také, že jste přidali příkaz pro vyvolání OtherInitialize metody z metody formuláře Load nebo konstruktoru (po volání 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
Poznámky
Událost, kterou lze zrušit, je vyvolána komponentou, když se chystá provést akci, která může být zrušena, například Closing událost události Form.
Poznámka:
Událost Closing je zastaralá a byla nahrazena .FormClosing Nabízí se jako příklad pouze pro ilustraci použití CancelEventArgs.
CancelEventArgs Cancel poskytuje vlastnost označující, zda má být událost zrušena.
Konstruktory
| Name | Description |
|---|---|
| CancelEventArgs() |
Inicializuje novou instanci CancelEventArgs třídy s vlastností nastavenou Cancel na |
| CancelEventArgs(Boolean) |
Inicializuje novou instanci CancelEventArgs třídy s Cancel vlastností nastavenou na danou hodnotu. |
Vlastnosti
| Name | Description |
|---|---|
| Cancel |
Získá nebo nastaví hodnotu určující, zda má být událost zrušena. |
Metody
| Name | Description |
|---|---|
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí funkce hash. (Zděděno od Object) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |