OnBarCheck ON_COMMAND_EX

最新推荐文章于 2018-01-05 16:24:45 发布

转载最新推荐文章于 2018-01-05 16:24:45 发布 · 1.8k 阅读

文章标签：

#command #扩展 #工具 #null

WIN32 / MFC 专栏收录该内容

35 篇文章

订阅专栏

CFrameWnd提供了OnBarCheck来响应与ID_VIEW_STATUS_BAR、ID_VIEW_TOOLBAR菜单项对应的命令。
消息映射：
ON_COMMAND_EX(ID_VIEW_STATUS_BAR,   OnBarCheck)
ON_COMMAND_EX(ID_VIEW_TOOLBAR,   OnBarCheck)
这里，使用了扩展命令消息映射宏把ID_VIEW_STATUS_BAR和ID_VIEW_TOOLBAR命令映射给同一个函数OnBarCheck处理。
OnBarCheck函数的实现：
BOOL CFrameWnd::OnBarCheck(UINT   nID)
{
    ASSERT(ID_VIEW_STATUS_BAR   ==   AFX_IDW_STATUS_BAR);
    ASSERT(ID_VIEW_TOOLBAR   ==   AFX_IDW_TOOLBAR);
    //得到工具条或者状态条
    CControlBar*   pBar   =   GetControlBar(nID);
    if   (pBar   !=   NULL)
    {
        //若控制条可见，则隐藏它；否则，显示它
        ShowControlBar(pBar,   (pBar-> GetStyle()   &   WS_VISIBLE)   ==   0,   FALSE);
        //处理完毕
        return   TRUE;
    }
    //可以让下一个命令目标继续处理
    return   FALSE;
}

由于是扩展映射宏定义的消息处理函数，所以OnBarCheck函数有一个UINT类型的参数和一个BOOL返回值。
当用户从“View”菜单选择打了钩的“Toolbar”时，消息处理函数OnBarCheck被调用，参数就是菜单项的ID号ID_VIEW_TOOLBAR，
它等于工具条的子窗口IDAFX_IDW_TOOLBAR。处理结果，工具条被隐藏；当再次选择该菜单项则工具条被显示。
处理状态条的过程类似于工具条的处理。

http://www.vczx.com/tutorial/mfc/mfc13.php

扩展映射宏和对应的普通映射宏的参数个数相同，含义一样。

但是扩展映射宏的消息处理函数的原型和对应的普通映射宏相比，有两个不同之处：

一是多了一个UINT类型的参数，另外就是有返回值（返回BOOL类型）。

回顾4.4.2章节，范围映射宏ON_COMMAND_RANGE的消息处理函数也有一个这样的参数，该参数在两处的含义是一样的，

即：1、命令消息扩展映射宏ON_COMMAND_EX定义的消息处理函数解释该参数是当前要处理的命令消息ID。

2、有返回值的意义在于：如果扩展映射宏的消息处理函数返回FALSE，则导致当前消息被发送给消息路径上的下一个消息目标处理。

综合来看，ON_COMMAND_EX宏有两个功能：

一是可以把多个命令消息指定给一个消息处理函数处理。这类似于ON_COMMAND_RANGE宏的作用。不过，这里的多条消息的命令ID或者控制子窗口ID可以不连续，每条消息都需要一个ON_COMMAND_EX宏。

二是可以让几个消息目标处理同一个命令或者通知或者反射消息。如果消息发送路径上较前的命令目标不处理消息或者处理消息后返回FALSE，则下一个命令目标将继续处理该消息。

对于通知消息、反射消息，它们也有扩展映射宏，而且上述论断也适合于它们。例如：

ON_NOTIFY对应的ON_NOTIFY_EX