演练：使用新的 MFC Shell 控件

在本演练中，你将创建类似于文件资源管理器的应用程序。 你将创建一个包含两个窗格的窗口。 左窗格将保存一个 CMFCShellTreeCtrl 对象，该对象在分层视图中显示桌面。 右窗格将保留一个 CMFCShellListCtrl，该 CMFCShellListCtrl 显示左窗格中所选文件夹中的文件。

先决条件

• 在 Visual Studio 2017 及更高版本中，MFC 支持是可选组件。 若要安装它，请从 Windows“开始”菜单打开 Visual Studio 安装程序。 找到正在使用的 Visual Studio 版本，然后选择 “修改 ”按钮。 确保选中 “使用 C++ 进行桌面开发 ”磁贴。 在 “可选组件”下，选中 “MFC 支持 ”按钮。

• 本演练假定已将 Visual Studio 设置为使用 常规开发设置。 如果使用的是其他开发设置，则默认情况下可能不会显示在本演练中使用的一些 Visual Studio 窗口。

使用 MFC 应用程序向导创建新的 MFC 应用程序

这些步骤因所使用的 Visual Studio 版本而异。 若要查看 Visual Studio 首选项的文档，请使用“版本”选择器控件。 它位于此页面上目录表的顶部。

通过生成并运行应用程序来验证其是否已成功创建。 若要生成应用程序，请从“ 生成 ”菜单中选择“ 生成解决方案”。 如果应用程序成功生成，请从“调试”菜单中选择“开始调试”来运行应用程序。

该向导会自动创建一个应用程序，该应用程序具有标准菜单栏、标准工具栏、标准状态栏和带有 文件夹 视图和 日历 视图的窗口左侧的 Outlook 栏。

将 shell 列表控件添加到文档视图

1. 在本部分中，你将向向导创建的视图添加一个实例 CMFCShellListCtrl 。 通过在解决方案资源管理器中双击 MFCShellControlsView.h 打开视图头文件。

   在 #pragma once 头文件顶部附近找到该指令。 紧接在其下方添加此代码以包括以下文件的 CMFCShellListCtrl头文件：

   #include <afxShellListCtrl.h>
   

   现在添加类型的成员 CMFCShellListCtrl变量。 首先，在头文件中找到以下注释：

   // Generated message map functions
   

   紧邻该注释的上方，添加以下代码：

   private:
   CMFCShellListCtrl m_wndList;
   

2. MFC 应用程序向导已在类中创建CMainFrame对象CMFCShellTreeCtrl，但它是受保护的成员。 稍后我们将访问该对象，因此立即为其创建访问器。 通过在 解决方案资源管理器中双击它打开 MainFrm.h 头文件。 找到以下注释：

   // Attributes
   

   紧接着，添加以下方法声明：

   public:
       CMFCShellTreeCtrl& GetShellTreeCtrl();
   

   接下来，在 解决方案资源管理器中双击MainFrm.cpp源文件。 在该文件的底部，添加以下方法定义：

   CMFCShellTreeCtrl& CMainFrame::GetShellTreeCtrl()
   {
        return m_wndTree;
   }
   

3. 现在， CMFCShellControlsView 我们将更新类以处理 WM_CREATE Windows 消息。 打开 “类视图 ”窗口并选择该 CMFCShellControlsView 类。 右键单击并选择“属性”。

   接下来，在 “类向导”中，单击“ 消息 ”选项卡。向下滚动，直到找到 WM_CREATE 消息。 从旁边的 WM_CREATE下拉列表中选择 <“Add> OnCreate”。 该命令为我们创建消息处理程序，并自动更新 MFC 消息映射。

   在方法中 OnCreate ，我们现在将创建对象 CMFCShellListCtrl 。 OnCreate在MFCShellControlsView.cpp源文件中找到方法定义，并将其实现替换为以下代码：

   int CMFCShellControlsView::OnCreate(LPCREATESTRUCT lpCreateStruct)
   {
       if (CView::OnCreate(lpCreateStruct) == -1)
           return -1;
   
       CRect rectDummy (0, 0, 0, 0);
   
       m_wndList.Create(WS_CHILD | WS_VISIBLE | LVS_REPORT,
           rectDummy, this, 1);
   
       return 0;
   }
   

4. 重复上一步，但对于 WM_SIZE 消息。 每当用户更改应用程序窗口的大小时，它都会重新绘制应用程序视图。 将方法的定义 OnSize 替换为以下代码：

   void CMFCShellControlsView::OnSize(UINT nType, int cx, int cy)
   {
       CView::OnSize(nType, cx, cy);
   
       m_wndList.SetWindowPos(NULL, -1, -1, cx, cy,
           SWP_NOMOVE | SWP_NOZORDER | SWP_NOACTIVATE);
   }
   

5. 最后一步是使用 CMFCShellTreeCtrl：：SetRelatedList 方法连接CMFCShellTreeCtrl和CMFCShellListCtrl对象。 调用 CMFCShellTreeCtrl::SetRelatedList后，将自动 CMFCShellListCtrl 显示所选 CMFCShellTreeCtrl项的内容。 我们将方法中的 OnActivateView 对象连接到从 CView：：OnActivateView 重写的对象。

   在 MFCShellControlsView.h 头文件中的 CMFCShellControlsView 类声明中，添加以下方法声明：

   protected:
   virtual void OnActivateView(BOOL bActivate,
       CView* pActivateView,
       CView* pDeactiveView);
   

   接下来，将方法的定义添加到MFCShellControlsView.cpp源文件：

   void CMFCShellControlsView::OnActivateView(BOOL bActivate,
       CView* pActivateView,
       CView* pDeactiveView)
   {
       if (bActivate&& AfxGetMainWnd() != NULL)
       {
           ((CMainFrame*)AfxGetMainWnd())->GetShellTreeCtrl().SetRelatedList(&m_wndList);
       }
   
       CView::OnActivateView(bActivate,
           pActivateView,
           pDeactiveView);
   }
   

   由于我们要从 CMainFrame 类调用方法，因此必须在MFCShellControlsView.cpp源文件顶部添加指令 #include ：

   #include "MainFrm.h"
   

6. 通过生成并运行应用程序来验证其是否已成功创建。 若要生成应用程序，请从“ 生成 ”菜单中选择“ 生成解决方案”。 如果应用程序成功生成，请从“调试”菜单中选择“开始调试”来运行它。

   现在，应该会在视图窗格中看到所选 CMFCShellTreeCtrl 项目的详细信息。 单击该 CMFCShellTreeCtrl节点时， CMFCShellListCtrl 将自动更新该节点。 同样，如果双击该CMFCShellListCtrl文件夹中的文件夹，则应自动更新。CMFCShellTreeCtrl

   右键单击树控件或列表控件中的任何项。 获得与使用真实 文件资源管理器时相同的上下文菜单。

后续步骤

• 该向导创建了一个 Outlook 栏，其中包含 “文件夹 ”窗格和 “日历 ”窗格。 在资源管理器窗口中拥有“日历”窗格可能没有意义，因此立即删除该窗格。

• 支持 CMFCShellListCtrl 以不同模式查看文件，例如 大图标、 小图标、 列表和 详细信息。 更新应用程序以实现此功能。 提示：请参阅 视觉C++示例。

另请参阅

演练