ホーム WTL Mobile
UI更新ハンドラ - 子ウィンドウ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2009/08/01
PR
 子ウィンドウ用のUI更新ハンドラは主に、ダイアログを「コンテナ」として、 ダイアログ上のコントロールの状態を更新するときに使用します。

 ところで、ポップアップメニューアイテム用のUI更新ハンドラはモーダルダイアログでもモードレスダイアログでも使用できますが、 ポップアップメニューアイテム以外(ツールバー、ステータスバー、子ウィンドウ)のUI更新ハンドラは モードレスダイアログでしか使用できません。 なぜなら、ポップアップメニューアイテム以外のUI更新ハンドラは 基本的にアイドルハンドラで呼び出されますが、モーダルダイアログにはアイドルハンドラが無いからです。

 ここでは、前回のポップアップメニューアイテム用のUI更新ハンドラを追加したモードレスダイアログに、 子ウィンドウ用のUI更新ハンドラを追加します。 [バージョン情報]メニューアイテムのオン/オフによって、 ダイアログ上の[バージョン情報を表示する]ボタンを使用可/使用不可にします。



プロジェクトファイル ダウンロード
// 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> // CUpdateUIを使用するため
			

// MainDlg.h
#pragma once

class CMainDlg : public CDialogImpl<CMainDlg>,
    public CMessageFilter, public CIdleHandler, public CUpdateUI<CMainDlg>
{
public:
    enum { IDD = IDD_MAINDLG };

    CMenu menu;

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

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

    // 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)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
        CHAIN_MSG_MAP(CUpdateUI<CMainDlg>)  // CUpdateUIへのチェイン
    END_MSG_MAP()

    BOOL OnInitDialog(CWindow wndFocus, LPARAM lInitParam){
        SHINITDLGINFO shidi = { SHIDIM_FLAGS, m_hWnd,
            SHIDIF_SIZEDLGFULLSCREEN | SHIDIF_DONEBUTTON };
        ::SHInitDialog(&shidi);

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

        // メニューバー作成
        SHMENUBARINFO mbi = {0};
        mbi.cbSize = sizeof(SHMENUBARINFO);
        mbi.hwndParent = m_hWnd;
        mbi.dwFlags = SHCMBF_HMENU;
        mbi.nToolBarId = (UINT)menu.m_hMenu;
        mbi.hInstRes = ModuleHelper::GetResourceInstance();
        ::SHCreateMenuBar(&mbi);

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

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

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

        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){
            MessageBox(_T("SampleProject"));
        }
    }

    void OnOK(UINT uNotifyCode, int nID, CWindow wndCtl){
        DestroyWindow();
        ::PostQuitMessage(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, CWindow wndCtl){
        DestroyWindow();
        ::PostQuitMessage(nID);
    }
};
			

// SampleProject.cpp
#include "stdafx.h"
#include "resource.h"
#include "MainDlg.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(NULL, szAppName);    
    if(hWnd){
        SetForegroundWindow((HWND)((ULONG) hWnd | 0x00000001));
        return 0;
    }

    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

    CMainDlg dlg;
    dlg.Create(NULL);
    dlg.ShowWindow(nCmdShow);

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 まず、UI更新ハンドラマップに、状態を更新するコントロールのリソースIDとUIタイプを登録します。 今回の例では[バージョン情報を表示する]ボタンを子ウィンドウ用UI更新ハンドラで更新するため、 リソースIDにはIDC_BUTTON_VERSION、UIタイプにはUPDUI_CHILDWINDOWを指定します。

 次に、WM_INITDIALOGメッセージハンドラでUIAddChildWindowContainer()を呼び出します。 UIAddChildWindowContainer()の引数には、更新するダイアログのハンドルを指定します。 UI更新ハンドラでは、ここで指定されたハンドルで識別されるダイアログ上のコントロールに対して更新処理を行います。

 次に、OnRMenuVersion()UIEnable()を呼び出して[バージョン情報を表示する]ボタンの状態を切り替えます。

 最後に、OnIdle()で、子ウィンドウ用の更新関数であるUIUpdateChildWindows()を呼び出します。

ここで注意しなければならないのは、UIEnable()を呼び出した直後に[バージョン情報を表示する]ボタンの状態が更新されるのではなく、 あくまでも、UIEnable()を呼び出した後のアイドル時に、 UI更新ハンドラによって自動的に更新されるということです。