Visual Studio 2010与Windows 7的完美配合，在本文中体现在Visual Studio 2010响应Ribbon控件消息上。UI美工们已经帮我们完成了设计工作，下面现在，该轮到程序员上场了!51CTO编辑推荐《Visual Studio 2010应用与开发详解》
在Ribbon界面编辑完成的基础上，我们来看看如何利用Windows Scenic Ribbon API处理各种控件消息，让Ribbon界面真正地投入使用。
如何利用XML文件创建Ribbon控件，对控件进行排布和设置控件的缩放策略等等，可以说，这些工作都是UI设计师的任务。对程序员来说，更重要的是对控件的消息进行处理实现其业务逻辑。
添加消息处理功能
我们可以创建了一个派生自IUIApplication的Ribbon界面宿主对象类CApplication，并利用这个类完成了Ribbon界面的创建，初始化以及与Windows应用程序的集成。要对Ribbon控件的消息进行处理，我们还是要借助这个宿主对象类。为了使得CApplication类具有控件消息处理的能力，我们需要修改它的定义，让它同时也从IUICommandHandler派生。而IUICommandHandler类，则是Scenic Ribbon API提供给我们的控件消息处理类，只要CApplication从这个类派生，就具有了相应的控件消息的处理能力。
为了对Visual Studio 2010响应Ribbon控件消息进行处理，我们修改CApplication类的定义如下：
- // 引入Scenic Ribbon API的头文件
- #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类的定义中，添加：
- public:
- BEGIN_COM_MAP(CApplication)
- COM_INTERFACE_ENTRY(IUIApplication)
- COM_INTERFACE_ENTRY(IUICommandHandler)
- END_COM_MAP()
这样，Visual Studio 2010响应Ribbon控件的消息就会发送到CApplication类，由CApplication类进行处理。在整个Scenic Ribbon API中，Ribbon控件消息的处理流程如下图所示。除了之前我们介绍的跟Ribbon界面创建和初始化相关的过程之外，为了完成控件消息，我们首先需要为感兴趣的控件进行注册，这些工作都会在OnCreateCommand函数中完成。完成控件的注册后，当我们需要进行消息处理的控件有消息发生时，IUIFramework就会将这些消息发送给CApplication，而我们就可以在CApplication类中对具体的消息进行处理。Ribbon控件的消息主要分成两种：一种是来自控件的动作消息，比如按钮控件被点击，ComboBox的选择发生了变化等。这类消息都在Execute函数中进行处理;另外一种是则对控件属性进行更新的消息，这类消息在UpdateProperty函数中进行处理。
注册感兴趣的控件
按照Ribbon界面控件消息的处理流程，我们首先需要在OnCreateCommand函数中为我们感兴趣的控件进行注册，这样当控件有动作发生的时候，CApplication类才会收到相应的控件消息，进而可以对其进行处理。在CApplication类的OnCreateCommand函数中，我们完成相应控件的注册：
- STDMETHOD(OnCreateUICommand)(UINT32 nCmdID, __in UI_COMMANDTYPE typeID, __deref_out IUICommandHandler** ppCommandHandler)
- {
- // 对相应控件的消息进行注册
- 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函数中，处理相应的按钮消息，实现控件属性的改变：
- 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)
- {
- //
- 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来实现控件属性的更新，所以对于第二种方式，我们还需要实现这个函数，在其中完成属性的更新：
- STDMETHODIMP UpdateProperty(UINT nCmdID,
- __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，拥抱Visual Studio 2010！
【编辑推荐】
