この記事は、Visual C++ のダイアログ ボックスにメニューがアタッチされている場合に発生する問題を解決するのに役立ちます。
元の製品バージョン: Visual C++、.NET 2002
元の KB 番号: 242577
現象
Note
Microsoft Visual C++ .NET 2002 および Visual C++ .NET 2003 では、.NET Framework によって提供されるマネージド コード モデルと、アンマネージ ネイティブ Windows コード モデルの両方がサポートされています。 この記事の情報は、アンマネージ Visual C++ コードにのみ適用されます。 Visual C++ 2005 では、.NET Framework によって提供されるマネージド コード モデルと、アンマネージド ネイティブ Windows コード モデルの両方がサポートされています。
メニューがダイアログ ボックスにアタッチされている場合、コマンド ユーザー インターフェイス (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 関数は、メニュー項目を反復処理し、項目がある場合は更新コマンド UI ハンドラーを呼び出します。 各メニュー項目の外観は、その状態 (有効/無効、オン/オフ) を反映するように更新されます。
CDialogにはOnInitMenuPopup ハンドラーがなく、メニュー項目に対して更新コマンド UI ハンドラーを呼び出さない CWnd の既定のハンドラーを使用するため、更新 UI メカニズムはダイアログ ボックス ベースのアプリケーションでは機能しません。
解決方法
この問題を解決するには、次の手順に従います。
メッセージ マップに
ON_WM_INITMENUPOPUPエントリを追加します。BEGIN_MESSAGE_MAP(CTestDlg, CDialog) // }} AFX_MSG_MAP ON_WM_INITMENUPOPUP() END_MESSAGE_MAP()OnInitMenuPopupメンバー関数をダイアログ ボックス クラスに追加し、次のコードをコピーします。Note
このコードの大部分は、WinFrm.cpp) の CFrameWnd::OnInitMenuPopup から取得されます。
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;
}
}
状態
この動作は仕様によるものです。
詳細
更新コマンド 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 でこの動作を再現するには、次の手順に従います。
AppWizard を使用して MFC ダイアログ ベースのアプリケーションを作成します。
新しいメニュー リソースを作成し、 File と File/Exit メニュー項目を追加します。
このメニューを、ダイアログ ボックス プロパティ ウィンドウのダイアログ ボックスのメニューとして設定します。 これを行うには、ダイアログ エディターでダイアログ リソースを開きます。 Properties ウィンドウで、メニューの選択クリック。 新しいメニュー リソースの ID がメニュー プロパティ エディターのドロップダウン リストに表示されます。
File/Exit メニュー項目の
UPDATE_COMMAND_UIハンドラーを追加します。 これを行うには、メニュー エディターで File/Exit を右クリックし、[イベント ハンドラーの追加 ] をクリック。 イベント ハンドラー ウィザードで、派生クラスCDialogプロジェクトにUPDATE_COMMAND_UIハンドラーを追加します。 Add をクリックし、Edit をクリックしてハンドラーを作成し、生成されたハンドラー メソッドに次のいずれかのステートメントを追加します。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.アプリケーションをビルドして実行します。