前言

FineUI中的Window控件常用作选择、新增或编辑内容。而关闭Window控件却有很多技巧，了解这些技巧有助于项目的快速开发。

如何关闭Window控件

第一个问题就是如何关闭Window控件，最明显的方式就是右上角的关闭图标了。总的说来，有三种方式：

1. ESC按键（在Window控件所在页面获取焦点的情况下，按下键盘的ESC将会关闭当前激活窗体）
2. 窗体右上角的关闭图标
3. 用户自定义的关闭按钮

前两种方式自不必说，那么如何自定义关闭按钮呢？有两种做法：

1. 按钮禁用回发，在页面初始化时注册关闭脚本

   1 <f:ButtonID="btnHideInClient"CssClass="inline"Text="隐藏窗体（客户端代码）"EnablePostBack="false"
   2 runat="server">
   3 </f:Button>

   1 protected void Page_Load(objectsender, EventArgs e)2 {3     if (!IsPostBack)4 {5         btnHideInClient.OnClientClick =Window2.GetHideReference();6 }7 }8  

2. 按钮回发，在回发事件中设置窗体Hidden属性，

   1 <f:ButtonID="btnHideInServer"Text="隐藏窗体（服务端代码）"runat="server"OnClick="btnHideInServer_Click">
   2 </f:Button>

   1 protected void btnHideInServer_Click(objectsender, EventArgs e)2 {3     Window2.Hidden = true;4 }

   或者注册关闭脚本：

   1 protected void btnHideInServer_Click(objectsender, EventArgs e)2 {3 PageContext.RegisterStartupScript(Window2.GetHideReference());4 }

当然，这里按钮是和Window控件在同样一个页面的。

对于另一种常见情况，也即启用IFrame的Window控件，位于IFrame页面内的按钮如何关闭父页面中的这个Window控件呢？

显然，我们无法在IFrame页面内获取Window控件的实例！

没关系，FineUI提供了ActiveWindow类来处理这个常见问题：

1 protected void btnSaveContinue_Click(objectsender, EventArgs e)2 {3 PageContext.RegisterStartupScript(ActiveWindow.GetHideReference());4 }

关闭窗体的方式

前面提到的关闭窗体，只是简单的关闭，并未做任何其他处理。其实FineUI提供了三种关闭窗体的方式：

1. 直接关闭：也就是前面提到的 GetHideReferene 方法返回的脚本
2. 关闭窗体，然后回发窗体所在的页面，触发Window控件的Close事件：可以使用内置的 GetHidePostBackReference 方法
3. 关闭窗体，然后刷新窗体所在的页面：可以使用内置的 GetHideRefreshReference 方法

再回到前面介绍的"如何关闭窗体"，显然前两种关闭方法（ESC，右上角关闭图标）无法使用 GetHide***Reference 方法，怎么办？

FineUI同时为Window控件提供了 CloseAction 属性，可能的值为 Hide，HidePostBack 和 HideRefresh，分别对应上述方法。

来看一个例子：

1. 初始显示
   
2. 点击右上角关闭图标，触发了Close事件
   
   这个行为是由Window控件的CloseAction属性控制的，来看下控件标签：

   1 <f:WindowID="Window2"Width="650px"Height="300px"Icon="TagBlue"Title="窗体"Hidden="true"
   2 EnableMaximize="true"EnableCollapse="true"runat="server"EnableResize="true"
   3 IsModal="false"CloseAction="HidePostBack"OnClose="Window2_Close"Layout="Fit">
   4 </f:Window>

   后台的事件处理代码：

   1 protected void Window2_Close(objectsender, WindowCloseEventArgs e)2 {3     Alert.ShowInTop("窗体被关闭了。参数：" + (String.IsNullOrEmpty(e.CloseArgument) ? "无": e.CloseArgument));4 }

   CloseAction无法定义返回参数，所以这里显示"无"！

3. 点击页面上的"隐藏窗体，带回发参数"，触发了Close 事件，此时的页面显示
   
   这个按钮的响应脚本是在页面初始化时注册的，如下所示（注意参数是如何设进去的）：

   1 protected void Page_Load(objectsender, EventArgs e)2 {3     if (!IsPostBack)4 {5         btnHideInClient2.OnClientClick = Window2.GetHidePostBackReference("btnHideInClient2");6 }7 }

同样，对于启用IFrame的Window控件，其IFrame内按钮的关闭窗体处理，对应于ActiveWindow的几个方法：

1. ActiveWindow.GetHideReference
2. ActiveWindow.GetHidePostBackReference
3. ActiveWindow.GetHideRefreshReference

关闭窗体的确认对话框

这个特性可能很多人都不知道，不过存在很强的实用性。

简单描述：启用IFrame的Window控件，如果IFrame页面内任意表单字段发生改变，则在关闭窗体时弹出确认框。

目的是防止用户在输入表单内容后，还没来的及保存，一个误操作把弹出窗体关了。

1. 页面初始显示
   
2. 在"数字输入框"内输入任意值，然后点击右上角的关闭图标，弹出确认对话框
   
3. 清空 "数字输入框"内的值（也即是还原到其初始状态），然后点击右上角的关闭图标，则直接关闭窗体

上述操作是由Window控件的 EnableConfirmOnClose 属性控制（默认为false），下面是这个Window实例的标签定义：

1 <f:WindowID="Window1"Hidden="true"EnableIFrame="true"runat="server"EnableConfirmOnClose="true"
2 EnableMaximize="true"EnableResize="true"Height="450px"Width="800px"Title="窗体一">
3 </f:Window>

对于上述页面中的"关闭"按钮，行为和右上角的关闭图标一致，不过这种一致性也是认为控制的，来看看"关闭"按钮的脚本：

1 protected void Page_Load(objectsender, EventArgs e)2 {3     if (!IsPostBack)4 {5         btnClose.OnClientClick =ActiveWindow.GetConfirmHideReference();6 }7 }

本章小结

本篇文章介绍了三种关闭Window控件的方法（ESC、关闭图标、自定义），以及三种FineUI定义的处理方式（隐藏、隐藏后回发、隐藏后刷新）。对于IFrame内的关闭按钮，FineUI提供了ActiveWindow来生成关闭脚本。同时还介绍了一个FineUI内置的属性 EnableConfirmOnClose ，用来控制是否弹出关闭窗体的确认对话框。

源代码与在线示例

本系列所有文章的源代码均可自行下载：http://fineui.codeplex.com/

在线示例：

1. http://fineui.com/demo/#/demo/window/window.aspx
2. http://fineui.com/demo/#/demo/iframe/window.aspx

如果本文对你有所启发或者帮助，请猛击“好文要顶”，支持原创，支持三石！

24张专业版高清大图

《FineUI小技巧》系列文章目录