Przewodnik: używanie nowych kontrolek powłoki MFC

W tym przewodniku utworzysz aplikację podobną do Eksploratora plików. Utworzysz okno z dwoma okienkami. Lewe okienko będzie zawierać obiekt CMFCShellTreeCtrl , który wyświetla pulpit w widoku hierarchicznym. W okienku po prawej stronie zostanie umieszczony CMFCShellListCtrl, który pokazuje pliki w folderze wybranym w okienku po lewej stronie.

Wymagania wstępne

• W programie Visual Studio 2017 lub nowszym obsługa MFC jest składnikiem opcjonalnym. Aby go zainstalować, otwórz Instalator programu Visual Studio z menu Start systemu Windows. Znajdź używaną wersję programu Visual Studio i wybierz przycisk Modyfikuj . Upewnij się, że kafelek Tworzenie aplikacji desktopowych w języku C++ jest zaznaczony. W obszarze Składniki opcjonalne sprawdź przycisk Obsługa MFC .

• W tym przewodniku założono, że skonfigurowaliśmy program Visual Studio do korzystania z ustawień ogólnych programowania. Jeśli używasz innego ustawienia programowania, niektóre okna programu Visual Studio używane w tym przewodniku mogą nie być domyślnie wyświetlane.

Aby utworzyć nową aplikację MFC przy użyciu Kreatora aplikacji MFC

Te kroki różnią się w zależności od używanej wersji programu Visual Studio. Aby zapoznać się z dokumentacją preferowanej wersji programu Visual Studio, użyj kontrolki selektora wersji . Znajduje się on w górnej części spisu treści na tej stronie.

Sprawdź, czy aplikacja została utworzona pomyślnie, kompilując i uruchamiając ją. Aby skompilować aplikację, w menu Kompilacja wybierz pozycję Kompiluj rozwiązanie. Jeśli aplikacja zostanie pomyślnie skompilowana, uruchom ją, wybierając opcję Rozpocznij debugowanie z menu Debug.

Kreator automatycznie tworzy aplikację z standardowym paskiem menu, standardowym paskiem narzędzi, standardowym paskiem stanu i paskiem programu Outlook po lewej stronie okna z widokiem Foldery i widokiem Kalendarz .

Aby dodać kontrolkę listy powłoki do widoku dokumentu

1. W tej sekcji dodasz wystąpienie CMFCShellListCtrl do widoku utworzonego przez kreatora. Otwórz plik nagłówka widoku, klikając dwukrotnie plik MFCShellControlsView.h w Eksploratorze rozwiązań.

   Znajdź dyrektywę #pragma once w górnej części pliku nagłówka. Natychmiast pod nim dodaj ten kod, aby dołączyć plik nagłówka dla elementu CMFCShellListCtrl.

   #include <afxShellListCtrl.h>
   

   Teraz dodaj zmienną składową typu CMFCShellListCtrl. Najpierw znajdź następujący komentarz w pliku nagłówka:

   // Generated message map functions
   

   Bezpośrednio nad tym komentarzem dodaj następujący kod:

   private:
   CMFCShellListCtrl m_wndList;
   

2. Kreator aplikacji MFC utworzył CMFCShellTreeCtrl już obiekt w CMainFrame klasie, ale jest to chroniona zmienna członkowska. Uzyskamy dostęp do obiektu później, więc teraz utwórzmy dla niego akcesor. Otwórz plik nagłówka MainFrm.h, klikając go dwukrotnie w Eksploratorze rozwiązań. Znajdź następujący komentarz:

   // Attributes
   

   Natychmiast pod nim dodaj następującą deklarację metody:

   public:
       CMFCShellTreeCtrl& GetShellTreeCtrl();
   

   Następnie otwórz plik źródłowy MainFrm.cpp, klikając go dwukrotnie w Eksploratorze rozwiązań. W dolnej części tego pliku dodaj następującą definicję metody:

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

3. Teraz zaktualizujemy klasę, aby obsługiwała komunikat systemu Windows CMFCShellControlsViewWM_CREATE. Otwórz okno Widok klasy i wybierz klasę CMFCShellControlsView . Kliknij prawym przyciskiem myszy i wybierz polecenie Właściwości.

   Następnie w Kreatorze klas kliknij kartę Komunikaty . Przewiń w dół do momentu znalezienia komunikatu WM_CREATE . Z listy rozwijanej obok WM_CREATE wybierz <Dodaj> onCreate. Polecenie tworzy program obsługi komunikatów dla nas i automatycznie aktualizuje mapę komunikatów MFC.

   W metodzie OnCreate utworzymy teraz nasz CMFCShellListCtrl obiekt. Znajdź definicję OnCreate metody w pliku źródłowym MFCShellControlsView.cpp i zastąp jego implementację następującym kodem:

   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. Powtórz poprzedni krok, ale dla komunikatu WM_SIZE . Spowoduje to ponowne rysowanie widoku aplikacji za każdym razem, gdy użytkownik zmieni rozmiar okna aplikacji. Zastąp definicję OnSize metody następującym kodem:

   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. Ostatnim krokiem jest połączenie CMFCShellTreeCtrl obiektów i CMFCShellListCtrl przy użyciu metody CMFCShellTreeCtrl::SetRelatedList . Po wywołaniu metody CMFCShellTreeCtrl::SetRelatedList, element CMFCShellListCtrl automatycznie wyświetli zawartość elementu wybranego w CMFCShellTreeCtrl. Łączymy obiekty w metodzie OnActivateView, który został przesłonięty w metodzie CView::OnActivateView.

   W pliku nagłówkowym MFCShellControlsView.h, wewnątrz deklaracji klasy CMFCShellControlsView, dodaj następującą deklarację metody:

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

   Następnie dodaj definicję metody do pliku źródłowego 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);
   }
   

   Ponieważ wywołujemy metody z CMainFrame klasy, musimy dodać dyrektywę #include w górnej części pliku źródłowego MFCShellControlsView.cpp:

   #include "MainFrm.h"
   

6. Sprawdź, czy aplikacja została utworzona pomyślnie, kompilując i uruchamiając ją. Aby skompilować aplikację, w menu Kompilacja wybierz pozycję Kompiluj rozwiązanie. Jeśli aplikacja zostanie pomyślnie skompilowana, uruchom ją, wybierając pozycję Rozpocznij debugowanie z menu Debug.

   Teraz szczegóły elementu wybranego w CMFCShellTreeCtrl powinny się wyświetlić w okienku widoku. Po kliknięciu węzła w CMFCShellTreeCtrl, CMFCShellListCtrl zostanie automatycznie zaktualizowany. Podobnie, jeśli dwukrotnie klikniesz folder w CMFCShellListCtrl, CMFCShellTreeCtrl powinien zostać automatycznie zaktualizowany.

   Kliknij prawym przyciskiem myszy dowolny element w kontrolce drzewa lub w kontrolce listy. Zostanie wyświetlone to samo menu kontekstowe, jak w przypadku korzystania z rzeczywistego Eksploratora plików.

Dalsze kroki

• Kreator utworzył pasek programu Outlook z okienkiem Foldery i okienkiem Kalendarz . Prawdopodobnie nie ma sensu mieć okienka Kalendarz w oknie Eksploratora , więc usuń to okienko teraz.

• Program CMFCShellListCtrl obsługuje wyświetlanie plików w różnych trybach, takich jak duże ikony, małe ikony, lista i szczegóły. Zaktualizuj aplikację, aby zaimplementować tę funkcję. Wskazówka: zobacz Przykłady języka Visual C++.

Zobacz także

Przewodniki