更新UI对象

1. /*
2.     更新UI对象
4.     常规情况下，菜单和工具栏按钮可以有多种状态。例如，菜单不可用时可以置灰，菜单
5.     正在被使用时可以设定为选中状态。同样工具栏也有这些状态。
7.     谁来更新这些可变状态项的状态？从逻辑上讲，如果一个菜单项产生了一个命令消息，
8.     此消息会被文档处理，那么由文档去更新可变状态项的状态更有意义，文档中应该包括
9.     可变状态项的状态信息。
11.     如果一个命令对应多个UI对象，比如一个菜单项和一个工具栏项，那么这两处的发出的
12.     命令将会被路由到同一个处理函数。这样就会在一处为多个同等的UI对象封装一份
13.     UI更新代码。
15.     编程框架提供了一个自动更新UI对象的快捷方法，你可以选择自己的更新方法，但框架
16.     提供的方法更有效且易于使用。
18.     1：更新函数何时被调用？
20.     假设用户通过鼠标点击了“文件”菜单，此操作会产生WM_INITMENUPOPUP消息，在菜单
21.     弹出之前，编程框架的更新机制会更新“文件”菜单下的所有菜单项，这样我们就可以
22.     看到各个菜单项的状态了。
24.     为了做到这一点，编程框架会以标准的命令路由方式路由弹出菜单的所有菜单项命令。
25.     在路由的过程中，通过检查消息映射入口，命令目标有机会更新任意的菜单项及调用
26.     更新函数。比如，一个菜单有六个菜单项，那个弹出之前，这六个更新命令都会被发送
27.     出去。如果存在与其相关的更新函数，则其会被更新状态。如果没有，编程框架会检查
28.     与命令ID相关的处理函数是否存在，并依据其更新菜单项的状态。
30.     如果在命令路由的过程中找不到相应的状态更新项，编程框架会自动去检查针对此命令
31.     ID的响应函数是否存在，如果存在则UI对象可用，如果不存在则不可用。
32.     所以，为了使一个UI对象可用，可以为其提供一个命令响应函数或者一个UI对象更新
33.     函数。二者存在一个即可。
35.     禁用UI对象的默认不可用属性是可以做到的，具体可以参照CFrameWnd的成员变量
36.     m_bAutoMenuEnable。
38.     编程框架中的菜单初始化是自动完成的，它发生在程序接收到消息WM_INITMENUPOPUP
39.     的时候。在IDLE时间内，编程框架会像查找菜单的更新函数一样为按钮也查找更新函数。
41.     2：宏ON_UPDATE_COMMAND_UI
43.     通过属性窗口可以自动地将UI对象的ID与其相应的更新函数联系起来。UI对象的更新
44.     函数的原型如下：
45. */
46. /*
47.     像所有的消息处理函数一样，更新函数的声明需要关键字afx_msg的支持
48.     所像所有的更新函数一样，它也需要一个参数，类型为CCmdUI*
49. */
50. afx_msg void OnUpdateEditClearAll(CCmdUI *pCmdUI);
52. /*
53.     3：类CCmdUI
55.     在路由更新命令的过程中，编程框架会为更新函数提供一个CCmdUI*类型的参数，它代表
56.     了产生更新命令的UI对象。更新函数会调用CCmdUI的成员函数去更新其代表的UI对象。
57.     示例代码如下：
58. */
59. void CMyWinApp::OnUpdateEditClearAll(CCmdUI *pCmdUI)
60. {
61.     pCmdUI->Enable(m_bClearAllAvailable);
62. }
63. /*
64.     CCmdUI的成员函数可操作的UI对象包括：
66.     Menu item，菜单项
67.             Enables or disables
68.             Checks (×) or unchecks
69.             Checks using dot (•)
70.             Sets item text
72.     Toolbar button，工具栏项
73.             Enables or disables
74.             Selects, unselects, or indeterminate
75.             Same as SetCheck
77.     Status-bar pane，状态栏项
78.             Makes text visible or invisible
79.             Sets pop-out or normal border
80.             Same as SetCheck
81.             Sets pane text
83.     Normal button in CDialogBar
84.             Enables or disables
85.             Checks or unchecks check box
86.             Same as SetCheck
87.             Sets button text
89.     Normal control in CDialogBar
90.             Enables or disables
91.             Sets window text
93.     成员函数有下面的五人：
94.         ContinueRouting
95.         Enable
96.         SetCheck
97.         SetRadio
98.         SetText
99. */