Пошаговое руководство. Использование новых элементов управления оболочкой MFC

В этом пошаговом руководстве вы создадите приложение, похожее на проводник. Вы создадите окно с двумя панелями. В левой области будет содержаться объект CMFCShellTreeCtrl , отображающий рабочий стол в иерархическом представлении. В правой панели будет находиться CMFCShellListCtrl, которая отображает файлы в папке, выбранной на левой панели.

Предпосылки

• В Visual Studio 2017 и более поздних версиях поддержка MFC является необязательным компонентом. Чтобы установить его, откройте установщик Visual Studio в меню "Пуск" Windows. Найдите используемую версию Visual Studio и нажмите кнопку "Изменить ". Убедитесь, что отмечена галочка на плитке "Разработка на компьютере с помощью C++". В разделе "Необязательные компоненты" нажмите кнопку поддержки MFC .

• В этом пошаговом руководстве предполагается, что вы настроили Visual Studio для использования общих параметров разработки. Если вы используете другой параметр разработки, некоторые окна Visual Studio, которые мы используем в этом пошаговом руководстве, могут не отображаться по умолчанию.

Создание нового приложения MFC с помощью мастера приложений MFC

Эти действия зависят от используемой версии Visual Studio. Чтобы ознакомиться с документацией по предпочтительной версии Visual Studio, используйте селектор Версия. Он находится в верхней части оглавления на этой странице.

Убедитесь, что приложение было успешно создано путем создания и запуска его. Чтобы создать приложение, в меню Сборка выберите Создать решение. Если приложение успешно выполняет сборку, запустите приложение, нажав кнопку "Начать отладку " в меню отладки .

Мастер автоматически создает приложение с стандартной строкой меню, стандартной панелью инструментов, стандартной строкой состояния и панелью Outlook слева от окна с представлением папок и представлением календаря .

Для добавления элемента управления списком проводника в представление документа

1. В этом разделе вы добавите экземпляр CMFCShellListCtrl в представление, созданное мастером. Откройте файл заголовка представления, дважды щелкнув MFCShellControlsView.h в обозревателе решений.

   Найдите директиву #pragma once в верхней части файла заголовка. Сразу же под этим кодом добавьте этот код, чтобы включить файл заголовка для CMFCShellListCtrl:

   #include <afxShellListCtrl.h>
   

   Теперь добавьте переменную члена типа CMFCShellListCtrl. Сначала найдите следующий комментарий в файле заголовка:

   // Generated message map functions
   

   Сразу над этим комментарием добавьте следующий код:

   private:
   CMFCShellListCtrl m_wndList;
   

2. Мастер приложений MFC уже создал CMFCShellTreeCtrl объект в CMainFrame классе, но это защищенный элемент. Позже мы получим доступ к объекту, поэтому теперь создадим для него метод доступа. Откройте файл заголовка MainFrm.h, дважды щелкнув его в обозревателе решений. Найдите следующий комментарий:

   // Attributes
   

   Сразу же под ним добавьте следующее объявление метода:

   public:
       CMFCShellTreeCtrl& GetShellTreeCtrl();
   

   Затем откройте исходный файл MainFrm.cpp, дважды щелкнув его в обозревателе решений. В нижней части этого файла добавьте следующее определение метода:

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

3. Теперь мы обновим CMFCShellControlsView класс для обработки WM_CREATE сообщения Windows. Откройте окно представления классов и выберите CMFCShellControlsView класс. Щелкните его правой кнопкой мыши и выберите Свойства.

   Затем в мастере классов щелкните вкладку "Сообщения ". Прокрутите вниз, пока не найдете WM_CREATE сообщение. В раскрывающемся списке рядом с WM_CREATE выберите <Добавить> 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 объектов и CMFCShellListCtrl объектов с помощью метода CMFCShellTreeCtrl::SetRelatedList . После вызова CMFCShellTreeCtrl::SetRelatedListCMFCShellListCtrl будет автоматически отображаться содержимое элемента, выбранного в элементе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 класса, мы должны добавить директиву #include в верхней части исходного файла MFCShellControlsView.cpp:

   #include "MainFrm.h"
   

6. Убедитесь, что приложение было успешно создано путем создания и запуска его. Чтобы создать приложение, в меню Сборка выберите Создать решение. Если приложение успешно строится, запустите его, нажав кнопку "Начать отладку " в меню отладки .

   Теперь вы увидите сведения об элементе, выбранном CMFCShellTreeCtrl в области представления. Когда вы щелкнете по узлу в CMFCShellTreeCtrl, CMFCShellListCtrl будет автоматически обновлено. Аналогичным образом, если дважды щелкнуть на папке в CMFCShellListCtrl, CMFCShellTreeCtrl должен быть автоматически обновлён.

   Щелкните правой кнопкой мыши любой элемент в элементе управления "Дерево" или в элементе управления списка. Вы получаете то же контекстное меню, что и если бы вы использовали реальный Проводник.

Дальнейшие шаги

• Мастер создал панель Outlook с областью папок и областью календаря . Вероятно, в окне обозревателя не имеет смысла иметь область календаря, поэтому удалите эту область сейчас.

• Он CMFCShellListCtrl поддерживает просмотр файлов в разных режимах, таких как большие значки, небольшие значки, список и сведения. Обновите приложение, чтобы реализовать эту функцию. Указание. См. примеры Visual C++.

См. также

пошаговое руководство