ホーム WTL Mobile
標準アプリケーションダイアログ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/08/12
PR
 WTLは標準的な Windows Mobile 用アプリケーションダイアログを作成するためにCAppStdDialogImplクラステンプレートを用意しています。 CAppStdDialogImplCStdDialogImplにレジストリを操作する機能や_tWinMain()の定型的な処理を簡略化する機能を追加したもので、 メインウィンドウの基底クラスとして使用します。

 次に示すのは、前回のバージョン情報ダイアログを追加したプログラムのメインウィンドウの基底クラスをCDialogImplからCAppStdDialogImplに変更する例です。 [バージョン情報]メニューアイテムのチェック状態をレジストリに保存します。

プロジェクトファイル ダウンロード
// 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>

#define _WTL_CE_NO_ZOOMSCROLL
#define _WTL_CE_NO_CONTROLS
#include <atlwince.h>     // CAppStdDialogImplを使用するため
			

// AboutDlg.h
#pragma once

class CAboutDlg : public CStdDialogImpl<CAboutDlg>
{
public:
    enum { IDD = IDD_ABOUTDLG };

    BEGIN_MSG_MAP(CAboutDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        CHAIN_MSG_MAP(CStdDialogImpl<CAboutDlg>)
    END_MSG_MAP()

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

        SetMsgHandled(false);

        return TRUE;
    }
};
			

// MainDlg.h
#pragma once

class CMainDlg : public CAppStdDialogImpl<CMainDlg>,
    public CMessageFilter, public CIdleHandler, public CUpdateUI<CMainDlg>
{
public:
    DECLARE_APP_DLG_CLASS(_T("SampleProject"), IDR_MAINFRAME, _T("Software\\WTL"))

    enum { IDD = IDD_MAINDLG };

    CMenu menu;
    CAccelerator m_acc;    // アクセラレータ

    virtual BOOL PreTranslateMessage(MSG* pMsg){
        // アクセラレータ処理
        if(!m_acc.IsNull() && m_acc.TranslateAccelerator(m_hWnd, pMsg))
            return TRUE;

        return CWindow::IsDialogMessage(pMsg);
    }

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

    void AppSave(){
        // [バージョン情報]メニューアイテムのチェック状態をレジストリに保存
        CAppInfo info;
        bool bCheck = (UIGetState(ID_RMENU_VERSION) & UPDUI_CHECKED) == UPDUI_CHECKED;
        info.Save(bCheck, _T("Version"));
    }

    // UI更新ハンドラマップ
    BEGIN_UPDATE_UI_MAP(CMainDlg)
        UPDATE_ELEMENT(ID_RMENU_VERSION, UPDUI_MENUPOPUP)
        UPDATE_ELEMENT(IDC_BUTTON_VERSION, UPDUI_CHILDWINDOW)
    END_UPDATE_UI_MAP()

    BEGIN_MSG_MAP(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        MSG_WM_DESTROY(OnDestroy)
        COMMAND_ID_HANDLER_EX(ID_RMENU_VERSION, OnRMenuVersion)
        COMMAND_ID_HANDLER_EX(IDC_BUTTON_VERSION, OnButtonVersion)
        CHAIN_MSG_MAP(CUpdateUI<CMainDlg>)         // CUpdateUIへのチェイン
        CHAIN_MSG_MAP(CAppStdDialogImpl<CMainDlg>) // CAppStdDialogImplへチェイン
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        // [バージョン情報]メニューアイテムのチェック状態をレジストリから取得
        CAppInfo info;
        bool bCheck = true;
        info.Restore(bCheck, _T("Version"));

        // メニューリソースを読み込む
        menu.LoadMenu(IDR_MAINFRAME);

        // メニューバー作成
        AtlCreateMenuBar(m_hWnd, (UINT)menu.m_hMenu, SHCMBF_HMENU);

        // [バージョン情報]メニューアイテムのチェックマーク設定
        UISetCheck(ID_RMENU_VERSION, bCheck);

        // ダイアログハンドルを子ウィンドウ用のUI更新ハンドラに追加
        UIAddChildWindowContainer(m_hWnd);
        
        // [バージョン情報を表示する]ボタンの使用可否設定
        UIEnable(IDC_BUTTON_VERSION, bCheck);

        // アクセラレータリソース読み込み
        m_acc.LoadAccelerators(IDR_MAINFRAME);

        // メッセージループにメッセージフィルタとアイドルハンドラを追加
        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 OnRMenuVersion(UINT uNotifyCode, int nID, CWindow wndCtl){
        bool bCheck = (UIGetState(ID_RMENU_VERSION) & UPDUI_CHECKED) != UPDUI_CHECKED;
        UISetCheck(ID_RMENU_VERSION, bCheck);

        // [バージョン情報を表示する]ボタンの使用可否設定
        UIEnable(IDC_BUTTON_VERSION, bCheck);
    }

    void OnButtonVersion(UINT uNotifyCode, int nID, CWindow wndCtl){
        if((UIGetState(ID_RMENU_VERSION) & UPDUI_CHECKED) == UPDUI_CHECKED){
            CAboutDlg dlg;
            dlg.DoModal();
        }
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "AboutDlg.h"
#include "MainDlg.h"

CAppModule _Module;

int APIENTRY _tWinMain(HINSTANCE hInstance, 
                       HINSTANCE hPrevInstance, 
                       LPTSTR    lpCmdLine, 
                       int       nCmdShow)
{
    HRESULT hRes = CMainDlg::ActivatePreviousInstance(hInstance, lpCmdLine);
    if(FAILED(hRes) || S_FALSE == hRes){
        return hRes;
    }

    _Module.Init(NULL, hInstance);

    int nRet = CMainDlg::AppRun(lpCmdLine, nCmdShow);

    _Module.Term();

    return nRet;
}
			

 まず、プロジェクトに文字列リソースを追加し、[ID]と[Caption]を次のように設定します。

リソース名 ID Caption
文字列 IDR_MAINFRAME SampleProject



 次に、メインウィンドウであるCMainDlgクラスの基底クラスを、 CDialogImplからCAppStdDialogImplに変更します。 CAppStdDialogImplの第1テンプレート引数には派生クラスの名前を渡し、 第2、第3テンプレート引数は省略可能で、それぞれSHInitDialog()で指定するダイアログフラグとモーダルダイアログかどうかのフラグが指定可能です。 第2テンプレート引数のデフォルト値はSHIDIF_DONEBUTTON | SHIDIF_SIPDOWN | SHIDIF_SIZEDLGFULLSCREENで、 第3テンプレート引数のデフォルト値はfalseです。

CMainDlgクラスでは、まず、DECLARE_APP_DLG_CLASSマクロを使用してウィンドウクラス名、 共通リソースID、アプリケーションが使用するレジストリキーを登録します。 このマクロはpublic宣言で使用しなければなりません。 なお、ここで指定したウィンドウクラス名は実際には登録されません。

 次に、メッセージマップにCAppStdDialogImplへのチェインを追加します。 CAppStdDialogImplの基底クラスはメッセージマップを用意しており、 メッセージによって次のようなメンバ関数を呼び出します。

メッセージ メンバ関数名 説明
WM_COPYDATA AppNewInstance アプリケーションの新しいインスタンスが生成された
WM_CLOSE AppSave アプリケーションを閉じる
WM_HIBERNATE または WM_ACTIVATE AppHibernate アプリケーションのリソースが不足している
WM_HOTKEY AppBackKey バックキーが押された

CAppStdDialogImplの派生クラスは、これらのメンバ関数をオーバーライドすることによって、 Windows Mobile アプリケーションの動作をカスタマイズすることができます。 今回の例ではAppSave()をオーバーライドし、 CAppInfo::Save()を呼び出して[バージョン情報]メニューアイテムのチェック状態をレジストリに保存します。 CAppInfoはアプリケーション情報をDECLARE_APP_DLG_CLASSマクロで設定したレジストリキーに対して保存/取得するクラスで、 CAppStdDialogImplの派生クラスで使用できます。

 次に、WM_INITDIALOGメッセージハンドラでは、 CAppInfo::Restore()を呼び出して[バージョン情報]メニューアイテムのチェック状態をレジストリから取得し、 メニューのチェックマークと[バージョン情報を表示する]ボタンの使用可否状態を設定します。

さらに、WM_INITDIALOGメッセージハンドラでは、 SHInitDialog()の呼び出しを削除し、SetMsgHandled(false)を呼び出します。 これは、CAppStdDialogImplの基底クラスにはWM_INITDIALOGメッセージハンドラが用意されており、 そこでSHInitDialog()が呼び出されているからです。 CAppStdDialogImplの第2テンプレート引数の値もそこで使用されます。

また、atlwince.hヘッダにはAtlCreateMenuBar()が定義されており、 SHCreateMenuBar()を使用するよりも簡単にメニューバーを作成できます。

 CAppStdDialogImplの基底クラスには、 リソースIDがIDOKIDCANCELWM_COMMANDメッセージハンドラも用意されています。 そこではDestroyWindow()PostQuitMessage()が呼び出されるため、 CMainDlgクラスからはリソースIDがIDOKIDCANCELWM_COMMANDメッセージハンドラを削除します。

 最後に_tWinMain()では、ActivatePreviousInstance()を呼び出して多重起動を防止し、 AppRun()を呼び出してアプリケーションを実行します。 なお、すでに同じアプリケーションが起動している場合、 WTLは共通リソースIDの文字列リソースと一致するタイトルのウィンドウをフォアグラウンドに表示します。 そのため、ダイアログでActivatePreviousInstance()を使用する場合は、 共通リソースID(今回の例ではIDR_MAINFRAME)の文字列リソースを用意し、 その[キャプション]にメインダイアログのタイトルと同じ文字列を設定する必要があります。

 このように、WTLは Windows Mobile の一般的なダイアログ用にCStdDialogImplと、 その派生クラスとしてアプリケーションのメインウィンドウ用にCAppStdDialogImplを用意しています。 同様に、WTLは次のようなクラステンプレートを用意しています。

ダイアログタイプ 一般的なダイアログ アプリケーションダイアログ
ダイアログ CStdDialogImpl CAppStdDialogImpl
ダイアログリサイズ CStdDialogResizeImpl CAppStdDialogResizeImpl
方向ダイアログ CStdOrientedDialogImpl CAppStdOrientedDialogImpl
ActiveXコントロールホスティングダイアログ CStdAxDialogImpl CAppStdAxDialogImpl
ActiveXコントロールホスティングダイアログリサイズ CStdAxDialogResizeImpl CAppStdAxDialogResizeImpl
ActiveXコントロールホスティング方向ダイアログ CStdAxOrientedDialogImpl CAppStdAxOrientedDialogImpl