Procédure pas à pas : utilisation des nouveaux contrôles d'environnement MFC

Dans cette procédure pas à pas, vous allez créer une application semblable à Explorateur de fichiers. Vous allez créer une fenêtre qui comporte deux volets. Le volet gauche contiendra un objet CMFCShellTreeCtrl qui affiche votre Bureau dans une vue hiérarchique. Le volet droit contiendra une cmFCShellListCtrl qui affiche les fichiers du dossier sélectionné dans le volet gauche.

Prérequis

• Dans Visual Studio 2017 et versions ultérieures, la prise en charge de MFC est un composant facultatif. Pour l’installer, ouvrez Visual Studio Installer à partir de Windows menu Démarrer. Recherchez la version de Visual Studio que vous utilisez et choisissez le bouton Modifier . Vérifiez que la vignette Desktop Development avec C++ est case activée ed. Sous Composants facultatifs, case activée le bouton Prise en charge de MFC.

• Cette procédure pas à pas suppose que vous avez configuré Visual Studio pour utiliser le Paramètres de développement général. Si vous utilisez un paramètre de développement différent, certaines fenêtres Visual Studio que nous utilisons dans cette procédure pas à pas peuvent ne pas être affichées par défaut.

Pour créer une application MFC à l’aide de l’Assistant Application MFC

Ces étapes varient selon la version de Visual Studio que vous utilisez. Pour consulter la documentation sur votre version préférée de Visual Studio, utilisez le contrôle de sélection de Version . Il se trouve en haut de la table des matières de cette page.

Vérifiez que l’application a été créée correctement en le créant et en l’exécutant. Pour générer l’application, dans le menu Générer , sélectionnez Build Solution. Si l’application est générée avec succès, exécutez l’application en sélectionnant Démarrer le débogage dans le menu Débogage .

L’Assistant crée automatiquement une application disposant d’une barre de menus standard, d’une barre d’outils standard, d’une barre d’état standard et d’une barre Outlook à gauche de la fenêtre avec un affichage Dossiers et un affichage Calendrier .

Pour ajouter le contrôle de liste d’interpréteurs de commandes à l’affichage de document

1. Dans cette section, vous allez ajouter une instance de CMFCShellListCtrl la vue créée par l’Assistant. Ouvrez le fichier d’en-tête d’affichage en double-cliquant sur MFCShellControlsView.h dans le Explorateur de solutions.

   Recherchez la #pragma once directive en haut du fichier d’en-tête. Immédiatement en dessous, ajoutez ce code pour inclure le fichier d’en-tête pour CMFCShellListCtrl:

   #include <afxShellListCtrl.h>
   

   Ajoutez maintenant une variable membre de type CMFCShellListCtrl. Tout d’abord, recherchez le commentaire suivant dans le fichier d’en-tête :

   // Generated message map functions
   

   Immédiatement au-dessus de ce commentaire, ajoutez ce code :

   private:
   CMFCShellListCtrl m_wndList;
   

2. L’Assistant Application MFC a déjà créé un CMFCShellTreeCtrl objet dans la CMainFrame classe, mais il s’agit d’un membre protégé. Nous allons accéder à l’objet ultérieurement, donc créer un accesseur pour celui-ci maintenant. Ouvrez le fichier d’en-tête MainFrm.h en double-cliquant dessus dans le Explorateur de solutions. Recherchez le commentaire suivant :

   // Attributes
   

   Immédiatement sous celui-ci, ajoutez la déclaration de méthode suivante :

   public:
       CMFCShellTreeCtrl& GetShellTreeCtrl();
   

   Ensuite, ouvrez le fichier source MainFrm.cpp en double-cliquant dessus dans le Explorateur de solutions. En bas de ce fichier, ajoutez la définition de méthode suivante :

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

3. À présent, nous mettons à jour la CMFCShellControlsView classe pour gérer le WM_CREATE message Windows. Ouvrez la fenêtre Affichage de classes et sélectionnez la CMFCShellControlsView classe. Effectuez un clic droit et sélectionnez Propriétés.

   Ensuite, dans l’Assistant Classe, cliquez sur l’onglet Messages . Faites défiler jusqu’à ce que vous trouviez le WM_CREATE message. Dans la liste déroulante en regard de WM_CREATE, sélectionnez <Ajouter> OnCreate. La commande crée un gestionnaire de messages pour nous et met automatiquement à jour la carte des messages MFC.

   Dans la OnCreate méthode, nous allons maintenant créer notre CMFCShellListCtrl objet. Recherchez la définition de méthode OnCreate dans le fichier source MFCShellControlsView.cpp et remplacez son implémentation par le code suivant :

   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. Répétez l’étape précédente, mais pour le WM_SIZE message. La vue de vos applications sera redessinée chaque fois qu’un utilisateur modifie la taille de la fenêtre d’application. Remplacez la définition de la OnSize méthode par le code suivant :

   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. La dernière étape consiste à connecter les CMFCShellTreeCtrl objets à CMFCShellListCtrl l’aide de la méthode CMFCShellTreeCtrl ::SetRelatedList . Une fois que vous avez appelé CMFCShellTreeCtrl::SetRelatedList, le CMFCShellListCtrl contenu de l’élément sélectionné est automatiquement affiché dans le CMFCShellTreeCtrl. Nous connectons les objets de la OnActivateView méthode, qui sont substitués à partir de CView ::OnActivateView.

   Dans le fichier d’en-tête MFCShellControlsView.h, à l’intérieur de la CMFCShellControlsView déclaration de classe, ajoutez la déclaration de méthode suivante :

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

   Ensuite, ajoutez la définition de la méthode au fichier source 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);
   }
   

   Étant donné que nous appelons des méthodes à partir de la CMainFrame classe, nous devons ajouter une #include directive en haut du fichier source MFCShellControlsView.cpp :

   #include "MainFrm.h"
   

6. Vérifiez que l’application a été créée correctement en le créant et en l’exécutant. Pour générer l’application, dans le menu Générer , sélectionnez Build Solution. Si l’application est générée avec succès, exécutez-la en sélectionnant Démarrer le débogage dans le menu Débogage .

   Vous devez maintenant voir les détails de l’élément sélectionné dans le CMFCShellTreeCtrl volet d’affichage. Lorsque vous cliquez sur un nœud dans le CMFCShellTreeCtrl, le CMFCShellListCtrl sera automatiquement mis à jour. De même, si vous double-cliquez sur un dossier dans le CMFCShellListCtrl, il CMFCShellTreeCtrl doit être automatiquement mis à jour.

   Cliquez avec le bouton droit sur n’importe quel élément dans le contrôle d’arborescence ou dans le contrôle de liste. Vous obtenez le même menu contextuel que si vous utilisiez le Explorateur de fichiers réel.

Étapes suivantes

• L’Assistant a créé une barre Outlook avec un volet Dossiers et un volet Calendrier . Il n’est probablement pas judicieux d’avoir un volet Calendrier dans une fenêtre Explorateur , donc supprimez-le maintenant.

• Il CMFCShellListCtrl prend en charge l’affichage de fichiers dans différents modes, tels que les grandes icônes, les petites icônes, la liste et les détails. Mettez à jour votre application pour implémenter cette fonctionnalité. Conseil : consultez les exemples Visual C++.

Voir aussi

Procédures pas à pas