CContextMenuManager 類別

發行項
02/28/2013

CContextMenuManager 物件處理捷徑功能表，也稱為內容功能表。

class CContextMenuManager : public CObject

Members

公用建構函式

名稱	描述
CContextMenuManager::CContextMenuManager	建構 CContextMenuManager 物件。
CContextMenuManager::~CContextMenuManager	解構函式。

公用方法

名稱	描述
CContextMenuManager::AddMenu	將新的捷徑功能表。
CContextMenuManager::GetMenuById	將控制代碼傳回給功能表與提供的資源 ID。.
CContextMenuManager::GetMenuByName	將控制代碼傳回給符合提供的功能表名稱的功能表。
CContextMenuManager::GetMenuNames	傳回功能表名稱清單。
CContextMenuManager::LoadState	裝載在 Windows 登錄中儲存的捷徑功能表。
CContextMenuManager::ResetState	清除內容功能表處理常式的捷徑功能表。
CContextMenuManager::SaveState	將捷徑功能表附加至 Windows 登錄中。
CContextMenuManager::SetDontCloseActiveMenu	控制項 CContextMenuManager 是否關閉使用中的捷徑功能表，因為它會顯示新的捷徑功能表。
CContextMenuManager::ShowPopupMenu	顯示指定的捷徑功能表。
CContextMenuManager::TrackPopupMenu	顯示指定的捷徑功能表。傳回選取的功能表命令的索引。

備註

CContextMenuManager 處理捷徑功能表並確定它們都有一致的外觀。

您無法以手動方式建立 CContextMenuManager 物件。您的應用程式架構建立 CContextMenuManager 物件。不過，在中，當您的應用程式初始化時，應該呼叫 CWinAppEx::InitContextMenuManager 。在初始化內容處理常式之後，請使用方法 CWinAppEx::GetContextMenuManager 取得指標給您應用程式的內容處理常式。

您可以建立捷徑功能表在執行階段時呼叫 AddMenu。如果您想要顯示功能表，而不用先接收使用者的輸入，請呼叫 ShowPopupMenu。TrackPopupMenu ，當您想要建立功能表和等候使用者輸入時，使用。TrackPopupMenu 傳回索引選項的命令或 0，如果使用者關閉，但未選取任何項目。

CContextMenuManager 也可以儲存和載入它的狀態至 Windows 登錄中。

範例

當 CContextMenuManager 物件顯示新的快顯功能表時，下列範例會示範如何將功能表加入至 CContextMenuManager 物件以及如何不關閉使用中的快顯功能表。這個程式碼片段是自訂呼叫範例的一部分。

    // The GetContextMenuManager method is inherited from the CWinAppEx class.
    GetContextMenuManager()->AddMenu (_T("My menu"), IDR_CONTEXT_MENU);
    GetContextMenuManager()->SetDontCloseActiveMenu(true);