ホーム ATL/WTL
デバイスコンテキスト
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2007/09/23
PR
 これまでの「Hello, ATL/WTL」プログラムでは、 WM_PAINTメッセージハンドラの処理をSDKスタイルで書いてきました。

// WM_PAINTメッセージハンドラ
void OnPaint(CDCHandle /*dc*/){
    PAINTSTRUCT ps;
    HDC hDC = BeginPaint(&ps);
    RECT rect;
    GetClientRect(&rect);
    DrawText(hDC, _T("Hello, ATL/WTL"),
        -1, &rect, DT_SINGLELINE | DT_CENTER | DT_VCENTER);
    EndPaint(&ps);
}
			

 WTLは、GDIをサポートするクラスを用意しています。 次に示すのは、前回のアイドルハンドラを追加した「Hello, ATL/WTL」プログラムの WM_PAINTメッセージハンドラを、WTLのGDIサポートクラスを使用して書き換えた例です。

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

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

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

// MainWindow.h
#pragma once

class CMainWindow : public CWindowImpl<CMainWindow>,
    public CMessageFilter, public CIdleHandler
{
public:
    DECLARE_WND_CLASS(_T("Hello"));

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        return FALSE;
    }

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_MSG_MAP(CMainWindow)
        MSG_WM_PAINT(OnPaint)
        MSG_WM_CREATE(OnCreate)
        MSG_WM_DESTROY(OnDestroy)
    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);
    }

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

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

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

CAppModule _Module;

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

    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

    CMainWindow wnd;
    wnd.Create(NULL, CWindow::rcDefault,
        _T("Hello, ATL/WTL"), WS_OVERLAPPEDWINDOW | WS_VISIBLE);

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 GDIサポートクラスはatlgdi.hヘッダに定義されていますが、 このヘッダはatlapp.hヘッダをインクルードした時点で自動的にインクルードされます。

 今回はRECT構造体をベースとするCRectというクラスを使用するため、 stdafx.hヘッダでatlmisc.hヘッダをインクルードします。atlmisc.hヘッダにはCRectクラスの他、 SIZE構造体をベースとするCSizeクラス、 POINT構造体をベースとするCPointクラス、 文字列をサポートするCStringクラスなどが定義されています。 atlmisc.hで定義されているこれらのクラスはMFCの同名のクラスとほぼ同じ機能を備えています。

 次に、WM_PAINTメッセージハンドラを書き換えます。 まず、CPaintDCクラスのインスタンスを作成します。 このクラスはコンストラクタで::BeginPaint()を呼び出してデバイスコンテキストを取得し、 デストラクタで::EndPaint()を呼び出します。 WM_PAINTメッセージハンドラでは次にクライアント領域の矩形を取得し、 中央に「Hello, ATL/WTL」という文字列を表示します。

 今回はデバイスコンテキストを取得するためにCPaintDCクラスを使用しましたが、 WTLはCPaintDCクラスを含め、次のようなデバイスコンテキスト取得クラスを用意しています。

CPaintDC
 WM_PAINTメッセージハンドラ専用のデバイスコンテキスト取得クラスです。 前述のとおり、コンストラクタで::BeginPaint()を呼び出してデバイスコンテキストを取得し、 デストラクタで::EndPaint()を呼び出します。

CClientDC
 WM_PAINTメッセージハンドラ以外の場所で、 ウィンドウのクライアント領域に描画するためのデバイスコンテキストを取得するクラスです。 コンストラクタで::GetDC()を呼び出してデバイスコンテキストを取得し、 デストラクタで::ReleaseDC()を呼び出してデバイスコンテキストを解放します。

CWindowDC
 ウィンドウのクライアント領域だけでなく、 非クライアント領域にも描画するためのデバイスコンテキストを取得するクラスです。 コンストラクタで::GetWindowDC()を呼び出してデバイスコンテキストを取得し、 デストラクタで::ReleaseDC()を呼び出してデバイスコンテキストを解放します。

CMemoryDC
 メモリデバイスコンテキストを取得するクラスです。

CEnhMetaFileDC
 拡張メタファイルデバイスコンテキストを作成します。

これらのクラスはすべてCDCというクラスから派生しています。 CDCクラスは、MFCの同名のクラスと同様、 デバイスコンテキストハンドルとそれに関するWin32APIをカプセル化します。 WTLのCDCクラスはさらに、DIBやOpenGLもサポートします。