ホーム ATL/WTL
UI更新ハンドラ - 子ウィンドウ
ドキュメント種別 ATL/WTL に関する文書
最終更新日 2003/12/31
PR
 前回のポップアップメニューアイテム用のUI更新ハンドラは、 モーダルダイアログでもモードレスダイアログでも有効でしたが、 ポップアップメニューアイテム以外(メニューバー、ツールバー、ステータスバー、子ウィンドウ)のUI更新ハンドラは モードレスダイアログでしか使えません。 なぜなら、ポップアップメニューアイテム以外のUI更新ハンドラは 基本的にアイドルハンドラで呼び出されますが、モーダルダイアログにはアイドルハンドラが無いからです。

 ここでは、前回ポップアップメニューアイテム用のUI更新ハンドラを追加したモードレスダイアログに、 子ウィンドウ用のUI更新ハンドラを追加します。 このとき、メニューの[常に手前に表示]のオン/オフによって、 ダイアログ上の[キャンセル]ボタンを使用可/使用不可になるようにしてみます。 このように、子ウィンドウ用のUI更新ハンドラは主に、ダイアログを「コンテナ」として、 ダイアログ上のコントロールの状態を更新するときに使用します。



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

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

// MainDlg.h内
class CMainDlg : public CDialogImpl<CMainDlg>,
    public CMessageFilter, public CIdleHandler, public CUpdateUI<CMainDlg>
{
public:
    enum { IDD = IDD_DIALOG1 };

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

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

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

    // メッセージマップ
    BEGIN_MSG_MAP_EX(CMainDlg)
        MSG_WM_INITDIALOG(OnInitDialog)
        COMMAND_ID_HANDLER_EX(ID_MENUITEM_TOPMOST, OnMenuTopmost)
        COMMAND_ID_HANDLER_EX(IDOK, OnOK)
        COMMAND_ID_HANDLER_EX(IDCANCEL, OnCancel)
        CHAIN_MSG_MAP(CUpdateUI<CMainDlg>)  
    END_MSG_MAP()

    LRESULT OnInitDialog(HWND hWnd, LPARAM lParam){
        // スクリーンの中央に配置
        CenterWindow();

        // 大きいアイコン設定
        HICON hIcon = AtlLoadIconImage(IDI_ICON1, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXICON), ::GetSystemMetrics(SM_CYICON));
        SetIcon(hIcon, TRUE);
        
        // 小さいアイコン設定
        HICON hIconSmall = AtlLoadIconImage(IDI_ICON1, LR_DEFAULTCOLOR,
            ::GetSystemMetrics(SM_CXSMICON), ::GetSystemMetrics(SM_CYSMICON));
        SetIcon(hIconSmall, FALSE);

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

        // ダイアログハンドルを子ウィンドウ用のUI更新ハンドラに追加
        UIAddChildWindowContainer(m_hWnd);
        
        // [キャンセル]ボタンの使用可否設定
        UIEnable(IDCANCEL, FALSE);
        
        // [常に手前に表示]メニューのチェックマーク設定
        UISetCheck(ID_MENUITEM_TOPMOST, false);

        return TRUE;
    }

    void OnMenuTopmost(UINT uNotifyCode, int nID, HWND hWndCtl){
        bool bTopmost = !(UIGetState(nID) & UPDUI_CHECKED);
        SetWindowPos(bTopmost ? HWND_TOPMOST : HWND_NOTOPMOST,
            0, 0, 0, 0, SWP_NOSIZE | SWP_NOMOVE | SWP_SHOWWINDOW);
        UISetCheck(nID, bTopmost);

        // [キャンセル]ボタンの使用可否設定
        UIEnable(IDCANCEL, bTopmost);
    }

    void OnOK(UINT uNotifyCode, int nID, HWND hWndCtl){
        DestroyWindow();
        ::PostQuitMessage(nID);
    }

    void OnCancel(UINT uNotifyCode, int nID, HWND hWndCtl){
        DestroyWindow();
        ::PostQuitMessage(nID);
    }
};
			

// modaless.cpp内
#include "stdafx.h"

#include "resource.h"

#include "MainDlg.h"

CAppModule _Module;

int WINAPI _tWinMain(HINSTANCE hInstance, HINSTANCE, LPTSTR lpCmdLine, int nCmdShow)
{
    _Module.Init(NULL, hInstance);

    CMessageLoop theLoop;
    _Module.AddMessageLoop(&theLoop);

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

    int nRet = theLoop.Run();

    _Module.RemoveMessageLoop();

    _Module.Term();

    return nRet;
}
			

 子ウィンドウ用のUI更新ハンドラを使用するにはまず、 アイドルハンドラに子ウィンドウ用のUI更新ハンドラであるUIUpdateChildWindows()を追加します。

 次に、UI更新ハンドラマップで、状態を更新するコントロールのリソースIDとUIタイプを登録します。 今回の例では[キャンセル]ボタンを子ウィンドウ用UI更新ハンドラで更新するため、 リソースIDにはIDCANCEL、UIタイプにはUPDUI_CHILDWINDOWを指定します。

 OnInitDialog()内では、コンテナとなるダイアログのハンドルを UIAddChildWindowContainer()によってUI更新ハンドラに追加します。 UI更新ハンドラでは、ここで指定されたダイアログ上のコントロールに対して更新処理を行います。

 最後に、OnMenuTopmost()内でUIEnable()を使うことによって、 [キャンセル]ボタンの状態を切り替えています。

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