拡張メタファイル

ホーム

ATL/WTL

拡張メタファイル

ドキュメント種別	ATL/WTL に関する文書
最終更新日	2007/09/23
PR

　WTLでは拡張メタファイルの機能をCEnhMetaFileTというクラステンプレートでカプセル化しています。テンプレート引数はbool値で、trueの場合はデストラクタでDeleteEnhMetaFile()を呼び出し、 falseの場合は呼び出しません。atlgdi.hヘッダではtypedefによって次のように宣言されています。

// atlgdi.h
typedef CEnhMetaFileT<false>  CEnhMetaFileHandle;
typedef CEnhMetaFileT<true>   CEnhMetaFile;

また、WTLは拡張メタファイル用デバイスコンテキストをCEnhMetaFileDCクラス、拡張メタファイル情報をCEnhMetaFileInfoクラスでカプセル化しています。

　以下に示すのは、WTLの拡張メタファイルサポートクラスを使用して、拡張メタファイルを作成、描画する例です。

	プロジェクトファイルダウンロード

// stdafx.h
#pragma once

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

#include <atlcrack.h>
#include <atlmisc.h>

// 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);

        CEnhMetaFile emf(::GetEnhMetaFile(_T("test.emf")));
        CRect rect;
        GetClientRect(rect);

        // 拡張メタファイルを描画
        dc.PlayMetaFile(emf, rect);
    }

    int OnCreate(LPCREATESTRUCT lpCreateStruct){
        // 拡張メタファイルを作成
        CEnhMetaFileDC dc(NULL, _T("test.emf"), NULL, NULL);

        // 青い格子ハッチのブラシを作成し、選択
        CBrush brush;
        brush.CreateHatchBrush(HS_CROSS, RGB(0, 0, 255));
        HBRUSH hOldBrush = dc.SelectBrush(brush);

        // クライアント矩形を取得し、円を描画
        CRect rect;
        GetClientRect(rect);
        dc.Ellipse(rect);

        // 元のブラシを選択
        dc.SelectBrush(hOldBrush);

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        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;
}

　まず、WM_CREATEメッセージハンドラで、カレントフォルダに拡張メタファイルを作成します。 CEnhMetaFileDCクラスの引数ありコンストラクタは内部でWin32APIのCreateEnhMetaFile()を呼び出しますが、デフォルトコンストラクタを使用した場合は何も呼び出しません。その場合は、CEnhMetaFileDCクラスのメンバ関数である Create()を呼び出すことで拡張メタファイルを作成できます。拡張メタファイルを作成したあとは、拡張メタファイル用デバイスコンテキストを使用して図形を描画します。

なお、CEnhMetaFileDCクラスのデストラクタではCloseEnhMetaFile()が呼び出されるため、拡張メタファイル用デバイスコンテキストを明示的に閉じる必要はありません。 Close()を呼び出せば明示的に閉じることができ、戻り値として拡張メタファイルのハンドルが取得できます。

　WM_PAINTメッセージハンドラでは、 Win32APIのGetEnhMetaFile()を呼び出して、先ほどWM_CREATEメッセージハンドラで作成した拡張メタファイルをカレントフォルダから読み込み、 PlayMetaFile()で拡張メタファイルの内容を描画します。