ペン

ホーム

WTL Mobile

ペン

ドキュメント種別	ATL/WTL に関する文書
最終更新日	2009/05/13
PR

　WTLではGDIオブジェクトのペンをCPenTというクラステンプレートでカプセル化しています。テンプレート引数はbool値で、trueの場合はデストラクタでDeleteObject()を呼び出し、 falseの場合は呼び出しません。atlgdi.hヘッダではtypedefによって次のように宣言されています。

// atlgdi.h
typedef CPenT<false>  CPenHandle;
typedef CPenT<true>   CPen;

　WTLのCPenクラスは、MFCの同名のクラスとほぼ同じメンバ関数を用意しています。以下に示すのは、CPenクラスを使用してクライアント矩形に接する青い円を描画する例です。

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

// 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>    // CRectを使用するため

// MainWindow.h
#pragma once

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

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

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_MSG_MAP(CMainWindow)
        MSG_WM_PAINT(OnPaint)
        MSG_WM_ACTIVATE(OnActivate)
        MSG_WM_SETTINGCHANGE(OnSettingChange)
        MSG_WM_CREATE(OnCreate)
        MSG_WM_DESTROY(OnDestroy)
    END_MSG_MAP()

    void OnPaint(CDCHandle /*dc*/){
        CPaintDC dc(m_hWnd);

        // 太さ2で青い実線のペンを作成し、選択
        CPen pen;
        pen.CreatePen(PS_SOLID, 2, RGB(0, 0, 255));
        HPEN hOldPen = dc.SelectPen(pen);

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

        // 元のペンを選択
        dc.SelectPen(hOldPen);
    }

    void OnActivate(UINT nState, BOOL bMinimized, CWindow wndOther){
        SHFullScreen(m_hWnd, SHFS_HIDESIPBUTTON);
    }

    void OnSettingChange(UINT uFlags, LPCTSTR lpszSection){
        SHFullScreen(m_hWnd, SHFS_HIDESIPBUTTON);
    }

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

    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.Create(NULL, CWindow::rcDefault, szAppName, WS_OVERLAPPEDWINDOW | WS_VISIBLE);

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}

　WM_PAINTメッセージハンドラで、まずペンオブジェクトを作成し、それをSelectPen()で現在のペンとして選択します。 SelectPen()は引数にHPEN型の変数を受け取りますが、 CPenTクラステンプレートはHPEN変換演算子を持っているのでそのまま渡すことができます。 SelectPen()は以前のペンハンドルを返すので、これをhOldPenという変数に保存しておきます。次に、円を描画します。太さが 2 で青い実線の円が描画されます。最後に、先ほど保存しておいた元のペンハンドルに戻すため、再度SelectPen()を呼び出して元のペンハンドルを選択します。

　ところで、WTLはストックペンもサポートしています。以下に示すのは、WM_PAINTメッセージハンドラでストックペンを使用して黒い実線の円を描画する例です。

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

// WM_PAINTメッセージハンドラ
void OnPaint(CDCHandle /*dc*/){
    CPaintDC dc(m_hWnd);

    // ストックペンを選択
    HPEN hOldPen = dc.SelectStockPen(BLACK_PEN);

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

    // 元のペンを選択
    dc.SelectPen(hOldPen);
}

また、atlmisc.hヘッダに定義されているAtlGetStockPen()というグローバル関数を使えば、ストックペンのハンドルを取得することができます。

// ストックペンのハンドルを取得
HPEN hStockPen = AtlGetStockPen(BLACK_PEN);