欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  后端开发

C#语言FormClosing与FormClosed事件中Args参数的CloseReason枚举

程序员文章站 2022-05-31 18:53:50
...
我的操作系统是Win7旗舰版,VS版本是VS2012,.NET版本为.NET Framework 4.5。

在窗体的FormClosing事件,第二个参数(FormClosingEventArgs类型)下有一个枚举变量CloseReason,在窗体的FormClosed事件,第二个参数(FormClosedEventArgs类型)下也有一个枚举变量CloseReason 。这个CloseReason枚举在命名空间System.Windows.Forms下。

如下段代码所示,CloseReason在窗体FormClosing事件的FormClosingEventArgs类型变量e中。

private void FormMain_FormClosing(object sender, FormClosingEventArgs e)
{
    switch (e.CloseReason)
    {
        case CloseReason.None: { MessageBox.Show("Closing: CloseReason.None"); } break;
        case CloseReason.WindowsShutDown: { MessageBox.Show("Closing: CloseReason.WindowsShutDown"); } break;
        case CloseReason.MdiFormClosing: { MessageBox.Show("Closing: CloseReason.MdiFormClosing"); } break;
        case CloseReason.UserClosing: { MessageBox.Show("Closing: CloseReason.UserClosing"); } break;
        case CloseReason.TaskManagerClosing: { MessageBox.Show("Closing: CloseReason.TaskManagerClosing"); } break;
        case CloseReason.FormOwnerClosing: { MessageBox.Show("Closing: CloseReason.FormOwnerClosing"); } break;
        case CloseReason.ApplicationExitCall: { MessageBox.Show("Closing: CloseReason.ApplicationExitCall"); } break;
    }
}

从元数据看,该枚举一共有下面7个枚举值:

#region 程序集 System.Windows.Forms.dll, v4.0.0.0
// C:\Program Files\Reference Assemblies\Microsoft\Framework\.NETFramework\v4.0\System.Windows.Forms.dll
#endregion

using System;

namespace System.Windows.Forms
{
    // 摘要:
    //     指定窗体关闭的原因。
    public enum CloseReason
    {
        // 摘要:
        //     关闭原因未定义或者无法确定。
        None = 0,
        //
        // 摘要:
        //     操作系统正在关闭所有应用程序以便准备关机。
        WindowsShutDown = 1,
        //
        // 摘要:
        //     此多文档界面 (MDI) 窗体的父窗体正在关闭。
        MdiFormClosing = 2,
        //
        // 摘要:
        //     用户正在通过用户界面 (UI) 关闭该窗体,例如通过单击窗体窗口上的“关闭”按钮,通过选择窗口控制菜单上的“关闭”按钮,或者通过按 Alt+F4
        //     等方式关闭。
        UserClosing = 3,
        //
        // 摘要:
        //     Microsoft Windows 任务管理器正在关闭应用程序。
        TaskManagerClosing = 4,
        //
        // 摘要:
        //     所有者窗体正在关闭。
        FormOwnerClosing = 5,
        //
        // 摘要:
        //     System.Windows.Forms.Application 类的 System.Windows.Forms.Application.Exit()
        //     方法被调用。
        ApplicationExitCall = 6,
    }
}

该枚举的MSDN可以参考页面:

https://msdn.microsoft.com/en-us/library/system.windows.forms.closereason(v=vs.110).aspx

除去None类型,本文对6种枚举值都进行了测试,在此记录下测试的结果。

1、CloseReason.WindowsShutDown

当Windows被注销、关闭时触发此CloseReason,不过不要在这里加入MessageBox等元素,因为一旦Windows发现当前程序迟迟关不掉,就会将此程序强制关闭。

2、CloseReason.MdiFormClosing

当前窗体为Mdi子窗体时,Mdi容器窗体被关闭时,在触发当前的FormClosing和FormClosed事件时提示此CloseReason。

将当前窗体作为MdiParent打开另一窗体的方法:

FormChild formChild = new FormChild();
formChild.MdiParent = this;
formChild.Show();

(需要将本窗体的IsMdiContainer设置为True)

3、CloseReason.UserClosing

用户手动关闭当前程序,比如调用Close()函数,或点击程序右上角的“×”,关闭原因都是CloseReason.UserClosing。

4、CloseReason.TaskManagerClosing

由任务管理器关闭窗口时,会触发此事件,但我在测试的时候发现,任务管理器关闭窗口具有一定的强制性。设置断点后可发现,FormClosing事件触发后不久程序就会被任务管理器强制关闭,这个时间非常短,因此不适合在此做一些诸如弹出MessageBox的事情(因为没有用)。

5、CloseReason.FormOwnerClosing

类似CloseReason.MdiFormClosing,如果窗体A是窗体B的owner,则窗体A关闭时,窗体B触发FormClosing和FormClosed事件时使用此CloseReason。

关于窗体作为owner的问题,可以参考MSDN页面:

https://msdn.microsoft.com/en-us/library/system.windows.window.owner(v=vs.110).aspx

将当前窗体作为Owner打开另一个窗体的方法:

FormChild formChild2 = new FormChild();
formChild2.Owner = this;
formChild2.Show();

6、CloseReason.ApplicationExitCall

调用Application.Exit()方法退出程序时,CloseReason为此值。

最后再说下FormClosing、FormClosed事件的调用顺序:

1、FormClosing事件在窗体关闭前触发,FormClosed事件在窗体关闭后触发

2、如果窗体A是mdi容器,窗体B的mdi-parent是窗体A,那么事件的调用顺序是:

窗体B - FormClosing事件 - CloseReason.MdiFormClosing

窗体A - FormClosing事件 - CloseReason.UserClosing

窗体B - FormClosed事件 - CloseReason.MdiFormClosing

窗体A - FormClosed事件 - CloseReason.UserClosing

3、如果窗体A是窗体B的owner,那么事件的调用顺序是:

窗体B - FormClosing事件 - CloseReason.FormOwnerClosing

窗体A - FormClosing事件 - CloseReason.UserClosing

窗体B - FormClosed事件 - CloseReason.FormOwnerClosing

窗体A - FormClosed事件 - CloseReason.UserClosing

相关标签: C#