UPDATE_COMMAND_UI
处理菜单对应的用户界面
COMMAND
处理该菜单对应的功能
传统SDK程序;要改变选单命令项状态,可以呼叫EnableMenuItem或是
CheckMenuItem,但这使得程序杂乱无章,因为你没有;个固定的位置和固定的原则处理命令项状态。MFC提供;种直觉并且仍旧依赖讯息观念的方式,解决这个问题,这就是UPDATE_COMMAND_UI讯息。其设计理念是,每当选单被拉;并尚未显示之前,其命令项(以及对应之工具栏按钮)都会收到UPDATE_COMMAND_UI讯息,这个讯息和WM_COMMAND有㆒样的绕行路线,我们(程序员)只要在适当的类别;放置其处理函式,并在函式;做某些判断,便可决定如何显示命令项。
这种方法的最大好处是,不但把问题的解决方式统化,更因为 Framework传给UPDATE_COMMAND_UI处理程序的参数是个「指向CCmdUI对象的指针」,而CCmdUI对象就代表着对应的选单命令项,因此你只需呼叫 CCmdUI 所准备的,专门用来处理命令项外观的函式(如Enable或SetCheck)即可。我们的工作量大为减轻。
(选摘自《深入浅出MFC》第9章)
UPDATE_COMMAND_UI
处理菜单对应的用户界面
COMMAND
处理该菜单对应的功能
说得很好:)
如果要使菜单变灰、或者在菜单项里面打勾
用那个UPDATE_COMMAND_UI,否则用command
例子:
void CMainFrame::OnUpdateSelectBlue(CCmdUI* pCmdUI)
{
// TODO: Add your command update UI handler code here
pCmdUI->SetCheck(true);//把菜单选中
}
3.7.1用户接口更新原理
为了理解用户接口更新机制,我们来看一下应用框架是如何实现用户接口更新的。当我们选择Edit菜单时,将产生一条WM_INITMENUPOPUP消息。框架的更新机制将在菜单拉下之前集体更新所有的项,然后再显示该菜单。
为了更新所有的菜单项,应用框架按标准的命令发送路线把该弹出式菜单中的所有菜单项的更新命令都发送出去。通过匹配命令和适当的消息映射条目(形式为ON_UPDATE_COMMAND_UI),并调用相应的更新处理器函数,就可以更新任何菜单项。比如,Edit菜单下有Undo、Cut、Copy、Paste等四个菜单项,就要发送四条用户接口更新命令。如果菜单项的命令ID有一个更新处理器,它就会被调用进行更新;如果不存在,则框架检查该命令ID的处理函数是否存在,并根据需要使菜单有效或无效。
如果在命令发送期间找不到对应于该命令的ON_UPDATE_COMMAND_UI项,那么框架就检查是否存在一个命令的ON_COMMAND项,如果存在,则使该菜单有效,否则就使该菜单无效(灰化)。这种更新机制仅适用于弹出式菜单,对于顶层菜单象File和Edit菜单,就不能使用这种更新机制。
按钮的命令更新机制与菜单的命令接口更新机制类似,只是工具条按钮的命令接口更新在空闲循环时完成。有关工具条按钮的接口更新机制,我们将在下一章“工具条和状态栏”中作详细介绍。
3.7.2 用户接口更新机制编程
当框架给处理函数发送更新命令时,它给处理函数传递一个指向CCmdUI对象的指针。这个对象包含了相应的菜单项或工具条按钮的指针。更新处理函数利用该指针调用菜单项或工具条的命令接口函数来更新用户接口对象(包括灰化,使,使能,选中菜单项和工具条按钮等)。下面我们使用前面的例子演示如何使用用户接口更新机制:
1.按Ctrl+W激活ClassWizard,选择Message Map选项页。
2.在Object IDs列表中选择 ID_SELECT_RED,在Messages列表中双击ON_UPDATE _COMMAND_UI条目,弹出Add Member Function对话框,缺省函数名为OnUpdateSelect Red,按OK按钮接收此函数名。OnUpdateSelectRed成员函数名就出现在Member Functions列表中。依次给ID_SELECT_BLUE、ID_SELECT_YELLOW增加OnUpdateSelectBlue和OnUpdateSelectYellow命令接口更新成员函数。
3.现在手工编辑刚才生成的成员函数,修改后形式如清单3.5所示:
清单3.5
void CMainFrame::OnUpdateSelectBlue(CCmdUI* pCmdUI)
{
// TODO: Add your command update UI handler code here
pCmdUI->SetCheck(m_nColor==BLUE);
}
void CMainFrame::OnUpdateSelectRed(CCmdUI* pCmdUI)
{
// TODO: Add your command update UI handler code here
pCmdUI->SetCheck(m_nColor==RED);
}
void CMainFrame::OnUpdateSelectYellow(CCmdUI* pCmdUI)
{
// TODO: Add your command update UI handler code here
pCmdUI->SetCheck(m_nColor==YELLOW);
}
现在编译运行Hello程序。当我们打开Test菜单时,如图3-14所示,在Red菜单项前已经有了一个对号。因为前面在CMainFrame构造函数中,我们已经将颜色初始化为RED。如果选择Blue,下次打开Test菜单时,在Blue菜单前就会有一个对号,而Red前面的对号则没有了。
图3-14
类似的,要根据某个状态开关菜单,也可以为菜单生成命令接口更新成员函数。比如,在Edit菜单中,如果当前剪贴板没有内容,Paste(粘贴)菜单应当设为无效,程序可以这么写:
void CMainFrame::OnUpdateEditPaste(CCmdUI* pCmdUI)
{
pCmdUI->Enable(!IsClipboardEmpty());
}
其中IsClipboardEmtpy()是读者自己编写的函数,用于判断剪贴板中是否有内容