チュートリアル: 新しい MFC シェル コントロールの使用

このチュートリアルでは、エクスプローラーに似たアプリケーションを作成します。 2 つのペインを含むウィンドウを作成します。 左側のウィンドウには、階層ビューでデスクトップを表示する CMFCShellTreeCtrl オブジェクトが保持されます。 右側のウィンドウには、左側のウィンドウで選択されているフォルダー内のファイルを示す CMFCShellListCtrl が表示されます。

[前提条件]

• Visual Studio 2017 以降では、MFC のサポートは省略可能なコンポーネントです。 インストールするには、Windows の [スタート] メニューから Visual Studio インストーラーを開きます。 使用している 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 アプリケーション ウィザードでは、CMainFrame クラスにCMFCShellTreeCtrl オブジェクトが既に作成されていますが、これは保護されたメンバーです。 後でオブジェクトにアクセスするので、ここでアクセサーを作成します。 ソリューション エクスプローラーで MainFrm.h ヘッダー ファイルをダブルクリックして開きます。 次のコメントを見つけます。

   // Attributes
   

   その直後に、次のメソッド宣言を追加します。

   public:
       CMFCShellTreeCtrl& GetShellTreeCtrl();
   

   次に、 ソリューション エクスプローラーでMainFrm.cppソース ファイルをダブルクリックして開きます。 そのファイルの下部に、次のメソッド定義を追加します。

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

3. 次に、 CMFCShellControlsView クラスを更新して、 WM_CREATE ウィンドウ メッセージを処理します。 [クラス ビュー] ウィンドウを開き、CMFCShellControlsView クラスを選択します。 右クリックし、[プロパティ] を選択します。

   次に、 クラス ウィザードの [ メッセージ ] タブをクリックします。 WM_CREATE メッセージが見つかるまで下にスクロールします。 [WM_CREATE] の横にあるドロップダウン リストから、[追加> OnCreate <選択します。 このコマンドは、メッセージ ハンドラーを作成し、MFC メッセージ マップを自動的に更新します。

   OnCreate メソッドで、CMFCShellListCtrl オブジェクトを作成します。 MFCShellControlsView.cpp ソース ファイルで OnCreate メソッド定義を見つけ、その実装を次のコードに置き換えます。

   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で選択した項目の内容を自動的に表示します。 CView::OnActivateView からオーバーライドされる 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では、大きいアイコン、小さいアイコン、リスト、詳細など、さまざまなモードでファイルを表示できます。 この機能を実装するようにアプリケーションを更新します。 ヒント: Visual C++ サンプルを参照してください。

こちらも参照ください

チュートリアル