ホーム WTL Mobile
ビューウィンドウ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/07/11
PR
 ビューウィンドウとは、フレームウィンドウのクライアント領域を覆うようにして表示される子ウィンドウのことです。 ここでは、これまで作成してきたフレームウィンドウにビューウィンドウを追加し、 ビューウィンドウの中央に「Hello, ATL/WTL」という文字列を描画します。


プロジェクトファイル ダウンロード
// stdafx.h
#pragma once

#define WINVER _WIN32_WCE
#define _SECURE_ATL 1

#include <atlbase.h>
#include <atlapp.h>
extern CAppModule _Module;
#include <atlwin.h>

#include <aygshell.h>
#pragma comment(lib, "aygshell.lib")

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlframe.h> // CFrameWindowImplを使用するため
			

// View.h
#pragma once

class CView : public CWindowImpl<CView>
{
public:
    DECLARE_WND_CLASS(NULL)

    // メッセージフィルタ処理
    BOOL PreTranslateMessage(MSG* pMsg){
        return FALSE;
    }

    // メッセージマップ
    BEGIN_MSG_MAP(CView)
        MSG_WM_PAINT(OnPaint)
    END_MSG_MAP()

    void OnPaint(CDCHandle /*dc*/){
        CPaintDC dc(m_hWnd);
        CRect rect;
        GetClientRect(rect);
        dc.DrawText(_T("Hello, ATL/WTL"), -1,
            rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER);
    }
};
			

// MainWindow.h
#pragma once

class CMainWindow : public CFrameWindowImpl<CMainWindow>,
    public CMessageFilter, public CIdleHandler, public CUpdateUI<CMainWindow>
{
public:
    // ウィンドウクラス名、共通リソースIDを登録
    DECLARE_FRAME_WND_CLASS(_T("SampleProject"), IDR_MAINFRAME)

    CView m_view;

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        // 基底クラスのPreTranslateMessageを呼び出す
        if(CFrameWindowImpl<CMainWindow>::PreTranslateMessage(pMsg))
            return TRUE;

        // ビューウィンドウクラスのPreTranslateMessageを呼び出す
        return m_view.IsWindow() ? m_view.PreTranslateMessage(pMsg) : FALSE;
    }

    virtual BOOL OnIdle(){
        UIUpdateToolBar();
        return FALSE;
    }

    // UI更新ハンドラマップ
    BEGIN_UPDATE_UI_MAP(CMainWindow)
        UPDATE_ELEMENT(ID_RMENU_STATUSBAR, UPDUI_MENUPOPUP | UPDUI_TOOLBAR)
    END_UPDATE_UI_MAP()

    BEGIN_MSG_MAP(CMainWindow)
        MSG_WM_CREATE(OnCreate)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_ID_HANDLER_EX(ID_RMENU_STATUSBAR, OnRMenuStatusbar)
        COMMAND_ID_HANDLER_EX(ID_RMENU_VERSION, OnRMenuVersion)
        COMMAND_ID_HANDLER_EX(ID_LMENU_CLOSE, OnLMenuClose)
        CHAIN_MSG_MAP(CUpdateUI<CMainWindow>)         // CUpdateUIへチェイン
        CHAIN_MSG_MAP(CFrameWindowImpl<CMainWindow>)  // CFrameWindowImplへチェイン
    END_MSG_MAP()

    int OnCreate(LPCREATESTRUCT lpCreateStruct){
        // メニューバー作成
        CreateSimpleCEMenuBar(IDR_MAINFRAME, SHCMBF_HMENU);

        // ツールバー作成
        HWND hWndToolBar = CreateSimpleCEToolBar();
        UIAddToolBar(hWndToolBar);

        // ステータスバー作成
        CreateSimpleStatusBar();

        // ビューウィンドウを作成
        m_hWndClient = m_view.Create(m_hWnd, rcDefault, NULL, 
            WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS | WS_CLIPCHILDREN);

        // [ステータスバー表示]メニューのチェックマーク設定
        UISetCheck(ID_RMENU_STATUSBAR, true);

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->AddMessageFilter(this);
        pLoop->AddIdleHandler(this);
        return 0;
    }

    void OnDestroy(){
        // メッセージループからメッセージフィルタとアイドルハンドラを削除
        CMessageLoop* pLoop = _Module.GetMessageLoop();
        pLoop->RemoveMessageFilter(this);
        pLoop->RemoveIdleHandler(this);
        SetMsgHandled(false);
    }

    void OnRMenuStatusbar(UINT uNotifyCode, int nID, CWindow wndCtl){
        bool bVisible = !::IsWindowVisible(m_hWndStatusBar);
        ::ShowWindow(m_hWndStatusBar, bVisible ? SW_SHOWNOACTIVATE : SW_HIDE);
        UpdateLayout();
        UISetCheck(ID_RMENU_STATUSBAR, bVisible);
    }

    void OnRMenuVersion(UINT uNotifyCode, int nID, CWindow wndCtl){
        MessageBox(_T("SampleProject"));
    }

    void OnLMenuClose(UINT uNotifyCode, int nID, CWindow wndCtl){
        PostMessage(WM_CLOSE);
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "View.h"
#include "MainWindow.h"

CAppModule _Module;

int APIENTRY _tWinMain(HINSTANCE hInstance, 
                       HINSTANCE hPrevInstance, 
                       LPTSTR    lpCmdLine, 
                       int       nCmdShow)
{
    UNREFERENCED_PARAMETER(hPrevInstance);
    UNREFERENCED_PARAMETER(lpCmdLine);

    TCHAR szAppName[] = _T("SampleProject");

    HWND hWnd = FindWindow(szAppName, szAppName);    
    if(hWnd){
        SetForegroundWindow((HWND)((ULONG) hWnd | 0x00000001));
        return 0;
    }

    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

    CMainWindow wnd;
    wnd.CreateEx();
    wnd.ShowWindow(nCmdShow);

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 まず、ビューウィンドウ用クラスを定義します。 今回の例ではプロジェクトにView.hというヘッダファイルを追加し、 そこにCWindowImplから派生したCViewというクラスを定義します。 このクラスには、独自のメッセージフィルタ関数であるPreTranslateMessage()と、 WM_PAINTメッセージハンドラを追加します。 WM_PAINTメッセージは、これまでフレームウィンドウ側で処理していましたが、 ビューウィンドウによってフレームウィンドウのクライアント領域が隠れてしまうため、 ビューウィンドウ側で処理します。 このため、フレームウィンドウであるCMainWindowクラスからは、 WM_PAINTメッセージハンドラを削除します。

 CMainWindowクラスでは、まず、 フレームウィンドウクラス名登録マクロをDECLARE_FRAME_WND_CLASS_EXから DECLARE_FRAME_WND_CLASSに変更します。 これは、ビューウィンドウを使用することによって、 フレームウィンドウのクライアント領域に直接「Hello, ATL/WTL」という文字列を描画しなくなるため、 CS_HREDRAW | CS_VREDRAW というスタイルを指定する必要がなくなるからです。

 次に、CMainWindowクラスのメッセージフィルタで、 CViewクラスの独自メッセージフィルタ関数を呼び出します。 これにより、ビューウィンドウにもメッセージフィルタリングの機会を与えます。

 次に、CViewクラスのインスタンスを、 CMainWindowクラスのメンバ変数として宣言します。 CMainWindowクラスのWM_CREATEメッセージハンドラではCreate()を呼び出してビューウィンドウを作成し、 その呼び出しによって得られたビューウィンドウのハンドルを、 CFrameWindowImplの基底クラスであるCFrameWindowImplBasem_hWndClientというHWND型のメンバ変数に代入します。 フレームウィンドウはビューウィンドウに対する操作を、このm_hWndClientで識別されるハンドルに対して行います。 例えば、CFrameWindowImplWM_SIZEメッセージハンドラを用意しており、 そこではUpdateLayout()という関数を呼び出して各バーやm_hWndClientで識別されるビューウィンドウを自動的にフレームウィンドウのサイズに調整します。

 最後に、SampleProject.cppファイルでMainWindow.hヘッダの前にView.hヘッダをインクルードします。