Visual C++ のダイアログ ボックスにメニューがアタッチされている場合、メニュー項目の状態をコマンド ユーザー インターフェイス ハンドラーから変更することはできません

この記事は、Visual C++ のダイアログ ボックスにメニューがアタッチされている場合に発生する問題を解決するのに役立ちます。

元の製品バージョン: Visual C++、.NET 2002
元の KB 番号: 242577

現象

メニュー項目の状態の変更 (有効化/無効化、チェック/オフ、テキストの変更) をコマンド ユーザー インターフェイス (UI) ハンドラーから行うと、メニューがダイアログ ボックスにアタッチされている場合、正しく動作しません。

void CTestDlg::OnUpdateFileExit(CCmdUI* pCmdUI)
{
    pCmdUI->Enable(FALSE); //Not calling the command handler, but does not show as disabled.
    pCmdUI->SetCheck(TRUE); // Does not show check mark before the text.
    pCmdUI->SetRadio(TRUE); // Does not show dot before the text.
    pCmdUI->SetText("Close"); //Does not change the text.
}

原因

ドロップダウン メニューが表示されると、メニュー項目を WM_INITMENUPOPUP 表示する前にメッセージが送信されます。 MFC CFrameWnd::OnInitMenuPopup 関数はメニュー項目を反復処理し、アイテムがある場合は update コマンド UI ハンドラーを呼び出します。 各メニュー項目の外観は、その状態 (有効/無効、チェック/オフ) を反映するように更新されます。

更新 UI メカニズムは、ダイアログ ボックス ベースのアプリケーションでは機能しません。ハンドラーがなくOnInitMenuPopup、CWnd の既定のハンドラーが使用されているためCDialog、メニュー項目に対して更新コマンド UI ハンドラーを呼び出しません。

解決方法

この問題を解決するには、次の手順に従います。

1. ON_WM_INITMENUPOPUPメッセージ マップにエントリを追加します。

   BEGIN_MESSAGE_MAP(CTestDlg, CDialog)
   // }} AFX_MSG_MAP
   
   ON_WM_INITMENUPOPUP()
   END_MESSAGE_MAP()
   

2. ダイアログ ボックス クラスに OnInitMenuPopup メンバー関数を追加し、次のコードをコピーします。

   注:

   このコードは、主に CFrameWnd::OnInitMenuPopup から取得WinFrm.cpp)

void CTestDlg::OnInitMenuPopup(CMenu *pPopupMenu, UINT nIndex,BOOL bSysMenu)
{
    // Make sure this is actually a menu. When clicking the program icon
    // in the window title bar this function will trigger and pPopupMenu 
    // will NOT be a menu.
    if (!IsMenu(pPopupMenu->m_hMenu))
		return;
        
    ASSERT(pPopupMenu != NULL);
    // Check the enabled state of various menu items.

    CCmdUI state;
    state.m_pMenu = pPopupMenu;
    ASSERT(state.m_pOther == NULL);
    ASSERT(state.m_pParentMenu == NULL);

    // Determine if menu is popup in top-level menu and set m_pOther to
    // it if so (m_pParentMenu == NULL indicates that it is secondary popup).
    HMENU hParentMenu;
    if (AfxGetThreadState()->m_hTrackingMenu == pPopupMenu->m_hMenu)
    state.m_pParentMenu = pPopupMenu; // Parent == child for tracking popup.
    else if ((hParentMenu = ::GetMenu(m_hWnd))!= NULL)
    {
        CWnd* pParent = this;
        // Child windows don't have menus--need to go to the top!
        if (pParent != NULL &&
        (hParentMenu = ::GetMenu(pParent->m_hWnd))!= NULL)
        {
            int nIndexMax = ::GetMenuItemCount(hParentMenu);
            for (int nIndex = 0; nIndex < nIndexMax; nIndex++)
            {
                if (::GetSubMenu(hParentMenu, nIndex) == pPopupMenu->m_hMenu)
            {
                // When popup is found, m_pParentMenu is containing menu.
                state.m_pParentMenu = CMenu::FromHandle(hParentMenu);
                break;
            }
            }
        }
    }

    state.m_nIndexMax = pPopupMenu->GetMenuItemCount();
    for (state.m_nIndex = 0; state.m_nIndex < state.m_nIndexMax;
    state.m_nIndex++)
    {
        state.m_nID = pPopupMenu->GetMenuItemID(state.m_nIndex);
        if (state.m_nID == 0)
        continue; // Menu separator or invalid cmd - ignore it.

        ASSERT(state.m_pOther == NULL);
        ASSERT(state.m_pMenu != NULL);
        if (state.m_nID == (UINT)-1)
        {
            // Possibly a popup menu, route to first item of that popup.
            state.m_pSubMenu = pPopupMenu->GetSubMenu(state.m_nIndex);
            if (state.m_pSubMenu == NULL ||
            (state.m_nID = state.m_pSubMenu->GetMenuItemID(0)) == 0 ||
            state.m_nID == (UINT)-1)
            {
            continue; // First item of popup can't be routed to.
            }
            state.DoUpdate(this, TRUE); // Popups are never auto disabled.
        }
        else
        {
            // Normal menu item.
            // Auto enable/disable if frame window has m_bAutoMenuEnable
            // set and command is _not_ a system command.
            state.m_pSubMenu = NULL;
            state.DoUpdate(this, FALSE);
        }

        // Adjust for menu deletions and additions.
        UINT nCount = pPopupMenu->GetMenuItemCount();
        if (nCount < state.m_nIndexMax)
        {
            state.m_nIndex -= (state.m_nIndexMax - nCount);
            while (state.m_nIndex < nCount &&
            pPopupMenu->GetMenuItemID(state.m_nIndex) == state.m_nID)
            {
                state.m_nIndex++;
            }
        }
        state.m_nIndexMax = nCount;
    }
}

状態

この動作は仕様です。

詳細

ルーティング前にコマンドが無効にされていないことを確認するために、update コマンド UI ハンドラーも から CWnd::OnCommand 呼び出されます。 これが、無効なメニュー項目に対してコマンド ハンドラーが呼び出されないのは、灰色 (使用不可) ではない場合でも発生する理由です。 この場合、メニュー項目は状態を反映するように描画されません。 これは、Wincore.cpp ファイルの関連コードです。

    // Make sure command has not become disabled before routing.
CTestCmdUI state;
state.m_nID = nID;
OnCmdMsg(nID, CN_UPDATE_COMMAND_UI, &state, NULL);
if (!state.m_bEnabled)
{
    TRACE1("Warning: not executing disabled command %d\n", nID);
    return TRUE;
}

動作の再現手順

Visual C++ .NET でこの動作を再現するには、次の手順に従います。

1. AppWizard を使用して MFC ダイアログ ベースのアプリケーションを作成します。

2. 新しいメニュー リソースを作成し、[ ファイル ] メニュー項目と [ ファイル/終了 ] メニュー項目を追加します。

3. ダイアログ ボックス プロパティ ウィンドウのダイアログ ボックスのメニューとしてこのメニューを設定します。 これを行うには、ダイアログ エディターでダイアログ リソースを開きます。 [ プロパティ ] ウィンドウで、[ メニュー] をクリックします。 新しいメニュー リソースの ID がメニュー プロパティ エディターのドロップダウン リストに表示されます。

4. UPDATE_COMMAND_UI[ファイル/終了] メニュー項目のハンドラーを追加します。 これを行うには、メニュー エディターで [ファイル/終了 ] を右クリックし、[ イベント ハンドラーの追加] をクリックします。 イベント ハンドラー ウィザードで、ハンドラーを UPDATE_COMMAND_UI プロジェクト CDialog 派生クラスに追加します。 [ 追加 と 編集] をクリックしてハンドラーを作成し、生成されたハンドラー メソッドに次のいずれかのステートメントを追加します。

   pCmdUI->Enable(FALSE); //Not calling the handler, but does not show as disabled
   pCmdUI->SetCheck(TRUE); // Does not show check mark before the text.
   pCmdUI->SetRadio(TRUE); // Does not show dot before the text.
   pCmdUI->SetText("Close"); //Does not change the text.
   

5. アプリケーションをビルドして実行します。