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

[アーティクル]
08/09/2011

このチュートリアルでは、Windows エクスプローラーのような外観のアプリケーションを作成します。ここでは、2 つのペインのあるウィンドウを作成します。左ペインにある CMFCShellTreeCtrl オブジェクトには、デスクトップが階層構造で表示されます。右ペインにある CMFCShellListCtrl には、左ペインで選択されたフォルダー内のファイルが表示されます。

必須コンポーネント

このチュートリアルは、読者が全般的な開発設定を使用することを指定して Visual Studio のセットアップを完了していることを前提としています。別の開発設定を使用している場合は、このチュートリアルで使用する一部の Visual Studio ウィンドウが既定で表示されないことがあります。

MFC アプリケーションウィザードを使用して新しい MFC アプリケーションを作成するには

MFC アプリケーションウィザードを使用して、新しい MFC アプリケーションを作成します。このウィザードを実行するには、[ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックします。 [新しいプロジェクト] ダイアログボックスが表示されます。
[新しいプロジェクト] ダイアログボックスの [プロジェクトの種類] ペインで、[Visual C++] ノードを展開し、[MFC] をクリックします。次に、[テンプレート] ペインで [MFC アプリケーション] をクリックします。プロジェクトの名前 (MFCShellControls など) を入力し、[OK] をクリックします。 MFC アプリケーションウィザードが表示されます。
[MFC アプリケーションウィザード] ダイアログボックスで、[次へ] をクリックします。 [アプリケーションの種類] ペインが表示されます。
[アプリケーションの種類] ペインの [アプリケーションの種類] で、[タブ付きドキュメント] をオフにします。次に、[シングルドキュメント] を選択し、[ドキュメント/ビューアーキテクチャのサポート] を選択します。 [プロジェクト形式] で、[Visual Studio] を選択し、[視覚スタイルと色] ボックスの一覧の [Office 2007 (青のテーマ)] をクリックします。その他のオプションはそのままにします。 [次へ] をクリックして、[複合ドキュメントサポート] ペインを表示します。
[複合ドキュメントサポート] ペインで、[なし] をクリックします。 [次へ] をクリックして、[ドキュメントテンプレート文字列] ペインを表示します。
[ドキュメントテンプレート文字列] ペインでは何も変更しません。 [次へ] をクリックして、[データベースサポート] ペインを表示します。
このアプリケーションではデータベースを使用しないため、[データベースサポート] ペインで [なし] を選択します。 [次へ] をクリックして、[ユーザーインターフェイス機能] ペインを表示します。
[ユーザーインターフェイス機能] ペインで、[メニューバーとツールバーを使用する] が選択されていることを確認します。その他のオプションはそのままにします。 [次へ] をクリックして、[高度な機能] ペインを表示します。
[高度な機能] ペインの [高度な機能] で、[ActiveX コントロール] と [コモンコントロールマニフェスト] のみを選択します。 [高度なフレームペイン] で、[ナビゲーションウィンドウ] のみを選択します。これにより、ウィンドウの左側に、CMFCShellTreeCtrl が埋め込まれた状態でナビゲーションウィンドウが作成されます。 [次へ] をクリックして、[生成されたクラス] ペインを表示します。
[生成されたクラス] ペインでは何も変更しません。 [完了] をクリックして、新しい MFC プロジェクトを作成します。
アプリケーションをビルドして実行することにより、アプリケーションが正常に作成されたことを確認します。アプリケーションをビルドするには、[ビルド] メニューの [ソリューションのビルド] をクリックします。アプリケーションが正常にビルドされたら、[デバッグ] メニューの [デバッグ開始] をクリックして、アプリケーションを実行します。

標準メニューバー、標準ツールバー、標準ステータスバー、およびウィンドウの左側にフォルダー ビューと予定表ビューのある Outlook バーを備えたアプリケーションが自動的に作成されます。

シェルリストコントロールをドキュメントビューに追加するには

ここでは、ウィザードによって作成されたビューに CMFCShellListCtrl のインスタンスを追加します。 ソリューションエクスプローラーで MFCShellControlsView.h ファイルをダブルクリックしてビューのヘッダーファイルを開きます。

ヘッダーファイルの先頭部分にある #pragma once ディレクティブを探します。その直後に、次のコードを追加して、CMFCShellListCtrl のヘッダーファイルをインクルードします。
```
#include <afxShellListCtrl.h>
```
次に、CMFCShellListCtrl 型のメンバー変数を追加します。最初に、ヘッダーファイルで次のコメントを探します。
```
// Generated message map functions
```
そのコメントの直前に、次のコードを追加します。
```
private:
    CMFCShellListCtrl m_wndList;
```
MFC アプリケーションウィザードによって既に CMainFrame クラスに CMFCShellTreeCtrl オブジェクトが作成されていますが、これはプロテクトメンバーです。後で、このオブジェクトにアクセスします。したがって、ここでアクセサーを作成します。 ソリューションエクスプローラーで MainFrm.h ヘッダーファイルをダブルクリックして開きます。次のコメントを探します。
```
// Attributes
```
この直後に、次のメソッド宣言を追加します。
```
public:
    CMFCShellTreeCtrl& GetShellTreeCtrl();
```
次に、ソリューションエクスプローラーで MainFrm.cpp ソースファイルをダブルクリックして開きます。このファイルの末尾に、次のメソッド定義を追加します。
```
CMFCShellTreeCtrl& CMainFrame::GetShellTreeCtrl()
{
    return m_wndTree;
}
```
WM_CREATE Windows メッセージを処理するように CMFCShellControlsView クラスを更新します。 MFCShellControlsView.h ヘッダーファイルを開き、次のコード行をクリックします。
```
class CMFCShellControlsView : public CView
```
次に、[プロパティ] ウィンドウで [メッセージ] アイコンをクリックします。スクロールダウンして 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;
}
```
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);
}
```
最後に、CMFCShellTreeCtrl::SetRelatedList メソッドを使用して、CMFCShellTreeCtrl オブジェクトと CMFCShellListCtrl オブジェクトを関連付けます。このメソッドを呼び出すと、CMFCShellTreeCtrl で選択された項目の内容が自動的に CMFCShellListCtrl に表示されます。これは、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"
```
アプリケーションをビルドして実行することにより、アプリケーションが正常に作成されたことを確認します。アプリケーションをビルドするには、[ビルド] メニューの [ソリューションのビルド] をクリックします。アプリケーションが正常にビルドされたら、[デバッグ] メニューの [デバッグ開始] をクリックして、アプリケーションを実行します。

CMFCShellTreeCtrl で選択されている項目の詳細が、ビューペインに表示されるようになりました。 CMFCShellTreeCtrl でノードをクリックすると、CMFCShellListCtrl が自動的に更新されます。また、CMFCShellListCtrl でフォルダーをダブルクリックすると、CMFCShellTreeCtrl が自動的に更新されます。

ツリーコントロールまたはリストコントロールの任意の項目を右クリックします。実際の Windows エクスプローラーを使用している場合と同じようなコンテキストメニューが表示されます。

次の手順

ウィザードによって、フォルダー ペインと予定表ペインのある Outlook バーが作成されました。エクスプローラーウィンドウには、おそらく予定表ペインは必要ありません。したがって、このペインを削除します。
CMFCShellListCtrl では、大きいアイコン、小さいアイコン、リスト、詳細などのさまざまなモードでファイルを表示できます。アプリケーションを更新して、この機能を実装します。ヒント:「エクスプローラのサンプル:MFC Windows Explorer アプリケーション」を参照してください。

参照

その他の技術情報

チュートリアル (MFC)

次の方法で共有

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

必須コンポーネント

MFC アプリケーションウィザードを使用して新しい MFC アプリケーションを作成するには

シェルリストコントロールをドキュメントビューに追加するには

次の手順

参照

その他の技術情報

その他のリソース

次の方法で共有

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

必須コンポーネント

MFC アプリケーション ウィザードを使用して新しい MFC アプリケーションを作成するには

シェル リスト コントロールをドキュメント ビューに追加するには

次の手順

参照

その他の技術情報

その他のリソース

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

MFC アプリケーションウィザードを使用して新しい MFC アプリケーションを作成するには

シェルリストコントロールをドキュメントビューに追加するには