上篇我们说到如何利用XML文件定义和描述Ribbon界面，从分工的意义上讲，其实那是UI设计师的活儿。作为程序员，更加专注的是如何对Ribbon控件的消息进行响应，完成相应的业务逻辑。现在，该轮到程序员上场了!在Ribbon界面编辑完成的基础上，我们来看看如何利用Windows Scenic Ribbon API处理各种控件消息，让Ribbon界面真正地投入使用。
在前面一篇文章中，我们讨论了如何利用XML文件创建Ribbon控件，对控件进行排布和设置控件的缩放策略等等，可以说，这些工作都是UI设计师的任务。对程序员来说，更重要的是对控件的消息进行处理实现其业务逻辑。
添加消息处理功能
大家应该还记得，在本系列前面的文章中，我们创建了一个派生自IUIApplication的Ribbon界面宿主对象类CApplication，并利用这个类完成了Ribbon界面的创建，初始化以及与Windows应用程序的集成。要对Ribbon控件的消息进行处理，我们还是要借助这个宿主对象类。为了使得CApplication类具有控件消息处理的能力，我们需要修改它的定义，让它同时也从IUICommandHandler派生。而IUICommandHandler类，则是Scenic Ribbon API提供给我们的控件消息处理类，只要CApplication从这个类派生，就具有了相应的控件消息的处理能力。
为了对控件消息进行处理，我们修改CApplication类的定义如下：
#include <uiribbon.h>
// 引入编译生成的资源头文件
#include "ribbonres.h"
// 调用Windows API获得系统时间
#include "windows.h"
#include "stdio.h"
IUIFramework* g_pFramework = NULL;
// Ribbon界面宿主程序
class CApplication
: public CComObjectRootEx<CComMultiThreadModel>
, public IUIApplication // 处理Ribbon界面的创建和初始化
, public IUICommandHandler // 处理Ribbon控件的消息
然后，我们需要利用COM_INTERFACE_ENTRY宏定义COM_MAP，在CApplication类的定义中，添加：
BEGIN_COM_MAP(CApplication)
COM_INTERFACE_ENTRY(IUIApplication)
COM_INTERFACE_ENTRY(IUICommandHandler)
END_COM_MAP()
这样，Ribbon控件的消息就会发送到CApplication类，由CApplication类进行处理。在整个Scenic Ribbon API中，Ribbon控件消息的处理流程如下图所示。除了之前我们介绍的跟Ribbon界面创建和初始化相关的过程之外，为了完成控件消息，我们首先需要为感兴趣的控件进行注册，这些工作都会在OnCreateCommand函数中完成。完成控件的注册后，当我们需要进行消息处理的控件有消息发生时，IUIFramework就会将这些消息发送给CApplication，而我们就可以在CApplication类中对具体的消息进行处理。Ribbon控件的消息主要分成两种：一种是来自控件的动作消息，比如按钮控件被点击，ComboBox的选择发生了变化等。这类消息都在Execute函数中进行处理;另外一种是则对控件属性进行更新的消息，这类消息在UpdateProperty函数中进行处理。
图1 Ribbon界面的消息处理流程
注册感兴趣的控件
按照Ribbon界面控件消息的处理流程，我们首先需要在OnCreateCommand函数中为我们感兴趣的控件进行注册，这样当控件有动作发生的时候，CApplication类才会收到相应的控件消息，进而可以对其进行处理。在CApplication类的OnCreateCommand函数中，我们完成相应控件的注册：
{
// 对相应控件的消息进行注册
if (nCmdID == cmdMyButton
|| nCmdID == cmdDeleteTable
|| nCmdID == cmdAddTable
|| nCmdID == cmdPrintRelationships)
{
return QueryInterface(IID_PPV_ARGS(ppCommandHandler));
}
return E_NOTIMPL;
}
在这段代码中，我们根据控件的Symbol选取了几个需要进行消息处理的控件，当这几个控件有动作发生时，比如比鼠标点击，或者是进行了选择，IUIFramework会发送相应的消息给宿主对象CApplication，从而让我们可以有机会对这些消息进行处理。
处理控件消息
对于普通的控件点击消息或者是选择消息等动作消息，我们需要重写CApplication类的消息处理函数Execute函数，在其中对消息进行处理：
STDMETHODIMP Execute(UINT nCmdID,
UI_EXECUTIONVERB verb,
__in_opt const PROPERTYKEY* key,
__in_opt const PROPVARIANT* ppropvarValue,
__in_opt IUISimplePropertySet* pCommandExecutionProperties)
{
HRESULT hr = S_OK;
switch (verb)
{
// 只处理感兴趣的消息类型
case UI_EXECUTIONVERB_EXECUTE:
// 判断消息来源
if (nCmdID == cmdMyButton)
{
// 执行具体的业务逻辑
// 这里我们获得系统时间并进行输出
SYSTEMTIME sys;
GetLocalTime( &sys );
wchar_t strInfo[256] = L"";
wsprintf( strInfo, L"当前系统时间：
%4d/%02d/%02d %02d:%02d:%02d.%03d 星期%1d\n",
sys.wYear,sys.wMonth,sys.wDay,
sys.wHour,sys.wMinute,sys.wSecond,sys.wMilliseconds,
sys.wDayOfWeek);
// 显示消息框
MessageBox(NULL, strInfo,
L"当前系统时间”,
MB_OK);
}
break;
}
return hr;
}
现在编译运行这个解决方案，当我们点击cmdMyButton 所对应的“MyButton”这个按钮时，就可以得到一个消息框报告当前的系统时间。当然，我们这里只是对按钮控件的动作进行处理，对于其他类型控件的消息处理，都是按照相同的流程进行。
图2 按钮控件的点击事件
在运行时对控件属性进行修改
在某些情况下，我们需要在运行时对控件的属性进行修改。例如，在应用程序运行的某种状态下，我们可能需要禁用某些控件，或者是修改控件的标签文本，图标等等。对控件属性的修改，可以通过直接修改控件属性达到，也可以通过调用InvalidateUICommand函数刷新控件的属性，然后在UpdateProperty函数中进行控件属性更改消息处理，实现具体的属性修改。下面我们分别来看看这两种方式是如何进行的。
在这个例子中，我们处理两个按钮控件的点击消息，让他们分别禁用另外的按钮控件和修改按钮的标签文本。在Execute函数中，处理相应的按钮消息，实现控件属性的改变：
UI_EXECUTIONVERB verb,
__in_opt const PROPERTYKEY* key,
__in_opt const PROPVARIANT* ppropvarValue,
__in_opt IUISimplePropertySet* pCommandExecutionProperties)
{
HRESULT hr = S_OK;
switch (verb)
{
case UI_EXECUTIONVERB_EXECUTE:
if (nCmdID == cmdMyButton)
{
//
PROPVARIANT varNew;
BOOL _fEnabled = FALSE;
// 初始化属性值
hr = UIInitPropertyFromBoolean(UI_PKEY_Enabled,
_fEnabled, &varNew);
if (FAILED(hr))
{
return hr;
}
// 为控件cmdDeleteTable设置新的属性值
hr = g_pFramework->SetUICommandProperty(cmdDeleteTable,
UI_PKEY_Enabled, varNew);
if (FAILED(hr))
{
return hr;
}
}
else if (nCmdID == cmdAddTable)
{
// 发送属性更新消息对控件属性UI_PKEY_Label进行更新
hr = g_pFramework->InvalidateUICommand(
cmdPrintRelationships,
UI_INVALIDATIONS_PROPERTY, &UI_PKEY_Label);
if (FAILED(hr))
{
return hr;
}
}
break;
}
return hr;
}
在cmdMyButton按钮的消息处理中，我们使用SetUICommandProperty就可以直接修改控件的属性了。在这里，我们通过设置cmdDeleteTable按钮控件的UI_PKEY_Enabled属性为FALSE，达到了禁用这个控件的目的。而在cmdAddTable按钮的消息处理中，我们只是调用了IUIFramework的InvalidateUICommand函数，这表示它会自动调用CApplication类的UpdateProperty来实现控件属性的更新，所以对于第二种方式，我们还需要实现这个函数，在其中完成属性的更新：
__in REFPROPERTYKEY key,
__in_opt const PROPVARIANT* ppropvarCurrentValue,
__out PROPVARIANT* ppropvarNewValue)
{
UNREFERENCED_PARAMETER(ppropvarCurrentValue);
HRESULT hr = E_FAIL;
if (key == UI_PKEY_Label)
{
// 更新控件cmdPrintRelationships的标签文本
if (nCmdID == cmdPrintRelationships)
{
hr = UIInitPropertyFromString(UI_PKEY_Label,
L"New Label", ppropvarNewValue);
}
}
return hr;
}
现在，我们就可以编译运行整个解决方案，点击相应的按钮控件，就可以看到对控件属性修改的效果了：
图3 修改控件属性
到这里，我们完成了整个Ribbon历程：从创建XML文件到添加宿主对象，从创建到初始化，从控件消息处理到控件属性更新。现在，Ribbon界面对我们来说，已经不再仅仅是微软的一种界面技术，她切切实实地来到了我们身边，可以为我们所用，提高应用程序的用户体验。
拥抱Ribbon，拥抱Windows 7!
