ホーム WTL Mobile
プロパティシート
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2010/01/20
PR
 WTLでは、プロパティシートとそのプロパティシート上に表示するタブ(プロパティページ)を、 それぞれCPropertySheetImplCPropertyPageImpl というクラステンプレートでカプセル化しています。 これらはATLのCDialogImplクラスのように基底クラスとしてのみ使用します。 atldlgs.hヘッダではそれぞれの派生クラスとして、 CPropertySheetクラスとCPropertyPageクラステンプレートが定義されています。

// atldlgs.h
class CPropertySheet : public CPropertySheetImpl<CPropertySheet>
{
    ...
    ...

template <WORD t_wDlgTemplateID>
class CPropertyPage : public CPropertyPageImpl<CPropertyPage<t_wDlgTemplateID> >
{
    ...
    ...
			

 WTLのCPropertySheetクラスとCPropertyPageクラステンプレートは、 MFCの同名のクラスと同等の機能を備えています。

ところで、Windows Mobile のプロパティシートには通常、メニューバーが設定されています。 このため、Windows Mobile では直接CPropertySheetクラスを使用するのではなく、 メニューバーを設定するためにCPropertySheetImplクラステンプレートの派生クラスを作成する必要があります。

 以下に示すのは、プロパティページとプロパティシートを作成する例です。 プロジェクトにCustomSheet.hというヘッダファイルを追加し、そこにCCustomPageというプロパティページクラスと CCustomSheetというプロパティシートクラスを定義します。 今回の例では、プロパティシートに2つのプロパティページを追加します。 1番目のプロパティページにはチェックボックスがあり、チェックを入れて[OK]ボタンを押すと、 タイトルバーにOEM情報を表示します。 2番目のプロパティページにはバージョン情報を表示します。 また、プロパティシートにはリンクテキストと空のメニューバーを設定します。



// CustomSheet.h
#pragma once

class CCustomPage : public CPropertyPageImpl<CCustomPage>
{
public:
    enum { IDD = IDD_PROPPAGE_WINDOW };

    CButton m_check_oem;

    bool m_bOem;

    // コンストラクタ
    CCustomPage(ATL::_U_STRINGorID title = (LPCTSTR)NULL)
        : CPropertyPageImpl<CCustomPage>(title), m_bOem(false)
    {}

    BEGIN_MSG_MAP(CCustomPage)
        MSG_WM_INITDIALOG(OnInitDialog)
        CHAIN_MSG_MAP(CPropertyPageImpl<CCustomPage>)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        m_check_oem = GetDlgItem(IDC_CHECK_OEM);

        m_check_oem.SetCheck(m_bOem);

        return TRUE;
    }

    BOOL OnKillActive(){
        m_bOem = (m_check_oem.GetCheck() != 0);

        return TRUE;
    }
};

class CCustomSheet : public CPropertySheetImpl<CCustomSheet>
{
public:
    CCustomPage m_pageCustom;
    CPropertyPage<IDD_PROPPAGE_VERSION> m_pageVersion;

    // コンストラクタ
    CCustomSheet(ATL::_U_STRINGorID title = (LPCTSTR)NULL,
        UINT uStartPage = 0, HWND hWndParent = NULL)
        : CPropertySheetImpl(title, uStartPage, hWndParent)
    {
        SetLinkText(_T("<file:notes{メモ}> を起動"));

        AddPage(m_pageCustom);
        AddPage(m_pageVersion);
    }

    BEGIN_MSG_MAP(CCustomSheet)
        CHAIN_MSG_MAP(CPropertySheetImpl<CCustomSheet>)
    END_MSG_MAP()

    void OnSheetInitialized(){
        AtlCreateEmptyMenuBar(m_hWnd);
    }
};
			

 まず、リソースを作成します。1番目のプロパティページ用にプロジェクトにダイアログリソースを追加して チェックボックスコントロールを配置し、 [ID]と[Caption]を次のように設定します。

コントロール名 ID Caption 備考
ダイアログ IDD_PROPPAGE_WINDOW ウィンドウ IDD_POCKETPC_PORTRAIT
チェックボックス IDC_CHECK_OEM タイトルバーにOEM情報を表示する

さらに、2番目のプロパティページ用にプロジェクトにダイアログリソースを追加して スタティックコントロールを配置し、 [ID]と[Caption]を次のように設定します。

コントロール名 ID Caption 備考
ダイアログ IDD_PROPPAGE_VERSION バージョン IDD_POCKETPC_PORTRAIT
スタティック IDC_STATIC SampleProject

 次に、1番目のプロパティページ用にCCustomPageクラスを定義します。 CCustomPageクラスでは、まず、enumによってダイアログリソースを関連付けます。 次にチェックボックスコントロール用にCButtonクラスのインスタンスをメンバ変数として宣言します。 これを使うためには、WM_INITDIALOGメッセージハンドラでコントロールのハンドルを代入する必要があります。 また、チェックボックスコントロールの状態を保持するためのbool型メンバ変数m_bOemを宣言します。

次に、CCustomPageクラスのコンストラクタではm_bOemを初期化し、 WM_INITDIALOGメッセージハンドラでは、 m_bOemの値をチェックボックスコントロールに設定します。

CCustomPageクラスでは最後に、 CPropertyPageImplのメンバ関数であるOnKillActive()をオーバーライドし、 チェックボックスコントロールの状態をm_bOemに保存します。 OnKillActive()はプロパティページがフォーカスを失う時 ([OK]ボタンを押してプロパティシートを閉じる時も含む)に呼び出されます。 つまり、プロパティシート(プロパティページ)を表示する前にm_bOemに値を設定し、 プロパティシート(プロパティページ)を閉じた後にm_bOemの値を取得することによって、 プロパティシートと外部のウィンドウがチェックボックスの状態を共有することができます。

CPropertyPageImplOnKillActive()を含め、 次のようなオーバーライド可能なメンバ関数を用意しています。 これらの関数は、プロパティページ用WM_NOTIFYメッセージの通知コードに応じて呼び出されます。

通知コード メンバ関数名
PSN_SETACTIVE OnSetActive
PSN_KILLACTIVE OnKillActive
PSN_APPLY OnApply
PSN_RESET OnReset
PSN_QUERYCANCEL OnQueryCancel
PSN_HELP OnHelp

 次に、プロパティシート用にCCustomSheetクラスを定義します。 CCustomSheetクラスのコンストラクタでは、 プロパティシートの下部にリンクテキストを設定するためにSetLinkText()を呼び出します。 リンクテキストは必須ではありませんが、Windows Mobile のプロパティシートで利用可能です。 なお、リンクテキストのリンク書式はRichInkコントロールのものと同様です。

さらに、CCustomSheetクラスのコンストラクタでは、 メンバ変数として宣言したプロパティページをAddPage()を呼び出して追加します。 1番目のプロパティページは先述のCCustomPageクラスで、 2番目のプロパティページはCPropertyPageクラステンプレートを使用したものです。 CPropertyPageのテンプレート引数にダイアログリソースIDを指定することで、 プロパティページにダイアログリソースを関連付けることができます。 動作をカスタマイズする必要のないプロパティページを作成するためには、この方法が最も簡単でしょう。 なお、プロパティページのタブ部分にはダイアログリソースのキャプションが表示されます。

CCustomSheetクラスでは最後に、 CPropertySheetImplのメンバ関数であるOnSheetInitialized()をオーバーライドし、 AtlCreateEmptyMenuBar()を呼び出して空のメニューバーを設定します。 OnSheetInitialized()はプロパティシートの初期化時に呼び出されます。

 次に示すのは、CCustomSheetクラスを使用する例です。

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

#define WINVER 0x0420
#include <atlbase.h>
#if _ATL_VER == 0x900
#define _SECURE_ATL 1
#endif

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

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

#include <atlcrack.h>
#include <atlmisc.h>
#include <atlframe.h>
#include <atlctrls.h>
#define _WTL_CE_NO_ZOOMSCROLL
#define _WTL_CE_NO_FULLSCREEN
#include <atlwince.h>
#include <atldlgs.h>
			

// SampleProjectDialog.h
#pragma once

class CSampleProjectDialog : 
    public CAppStdDialogImpl<CSampleProjectDialog>,
    public CUpdateUI<CSampleProjectDialog>,
    public CMessageFilter, public CIdleHandler
{
public:
    DECLARE_APP_DLG_CLASS(NULL, IDR_MAINFRAME, L"Software\\WTL")

    enum { IDD = IDD_MAINDLG };

    bool m_bOem;

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        return CWindow::IsDialogMessage(pMsg);
    }

    virtual BOOL OnIdle(){
        return FALSE;
    }

    BEGIN_UPDATE_UI_MAP(CSampleProjectDialog)
    END_UPDATE_UI_MAP()

    BEGIN_MSG_MAP(CSampleProjectDialog)
        MSG_WM_INITDIALOG(OnInitDialog)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_ID_HANDLER_EX(IDC_BUTTON_SHOW, OnButtonShow)
        CHAIN_MSG_MAP(CUpdateUI<CSampleProjectDialog>)
        CHAIN_MSG_MAP(CAppStdDialogImpl<CSampleProjectDialog>)
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        AtlCreateEmptyMenuBar(m_hWnd);

        m_bOem = false;

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

        SetMsgHandled(false);

        return TRUE;
    }

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

    void OnButtonShow(UINT uNotifyCode, int nID, CWindow wndCtl){
        CCustomSheet sheet(_T("サンプル"));
        sheet.m_pageCustom.m_bOem = m_bOem;

        if(sheet.DoModal() == IDOK){
            m_bOem = sheet.m_pageCustom.m_bOem;
            if(m_bOem){
                TCHAR szOem[256];
                SystemParametersInfo(SPI_GETOEMINFO, sizeof(szOem), szOem, 0);
                SetWindowText(szOem);
            }else{
                SetWindowText(_T("SampleProject"));
            }
        }
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resourceppc.h"
#include "CustomSheet.h"
#include "SampleProjectDialog.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance,
    HINSTANCE /*hPrevInstance*/, LPTSTR lpstrCmdLine, int nCmdShow)
{
    HRESULT hRes =
        CSampleProjectDialog::ActivatePreviousInstance(hInstance, lpstrCmdLine);

    if(FAILED(hRes) || S_FALSE == hRes){
        return hRes;
    }

    hRes = ::CoInitializeEx(NULL, COINIT_MULTITHREADED);
    ATLASSERT(SUCCEEDED(hRes));

    AtlInitCommonControls(ICC_DATE_CLASSES);
    SHInitExtraControls();

    hRes = _Module.Init(NULL, hInstance);
    ATLASSERT(SUCCEEDED(hRes));

    int nRet = CSampleProjectDialog::AppRun(lpstrCmdLine, nCmdShow);

    _Module.Term();
    ::CoUninitialize();

    return nRet;
}
			

 まず、リソースを作成します。ダイアログにボタンコントロールを配置し、 [ID]と[Caption]を次のように設定します。

コントロール名 ID Caption
ボタン IDC_BUTTON_SHOW プロパティシートを表示する

 次に、stdafx.hヘッダでは、CPropertySheetImplクラステンプレートとCPropertyPageImplクラステンプレートを使用するためにatldlgs.hヘッダをインクルードします。

 CSampleProjectDialogクラスでは、リソースIDがIDC_BUTTON_SHOWWM_COMMANDメッセージハンドラとして OnButtonShow()を追加します。 このハンドラ関数では、まず、CCustomSheetクラスのインスタンスを作成します。 CCustomSheetクラスのコンストラクタに文字列を指定することによって、 プロパティシートのタイトル文字列を設定することができます。

プロパティシートをモーダル表示するためにはCPropertySheetクラスのメンバ関数であるDoModal()を呼び出します。 [OK]ボタンを押してプロパティシートを閉じた場合は、 戻り値としてIDOKが返ります。

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