CMenuTearOffManager 類別
管理 Tear-Off 功能表。 Tear-Off 功能表是在功能表列上的功能表。 使用者可以取下功能表列中的 Tear-Off 功能表,讓 Tear-Off 功能表浮動。
如需更多詳細資料,請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。
語法
class CMenuTearOffManager : public CObject
成員
公用建構函式
名稱 | 描述 |
---|---|
CMenuTearOffManager::CMenuTearOffManager | 建構 CMenuTearOffManager 物件。 |
公用方法
備註
若要在應用程式中使用卸除功能表,您必須有 CMenuTearOffManager
物件。 在大部分情況下,您不會直接建立或初始化 CMenuTearOffManager
物件。 當您呼叫 CWinAppEx::EnableTearOffMenus 函式時,會為您處理此問題。
範例
下列範例示範如何藉由呼叫 CWinAppEX::EnableTearOffMenus
方法來建構和初始化 CMenuTearOffManager
物件。 此程式碼片段是 WordPad 範例的一部分。
// The EnableTearOffMenus method is inherited from the CWinAppEx class.
EnableTearOffMenus(NULL, ID_FREE_TEAROFF1, ID_FREE_TEAROFF2);
繼承階層架構
CMenuTearOffManager
需求
標頭: afxmenutearoffmanager.h
CMenuTearOffManager::Build
void Build(
UINT uiTearOffBarID,
CString& strText);
參數
[in] uiTearOffBarID
[in] strText
備註
CMenuTearOffManager::CMenuTearOffManager
CMenuTearOffManager();
備註
在大部分情況下,您不應該手動建立 CMenuTearOffManager
。 當您呼叫 CWinAppEx::EnableTearOffMenus 時,CMenuTearOffManager
應用程式的架構會建立 物件。
CMenuTearOffManager::GetRegPath
LPCTSTR GetRegPath() const;
傳回值
備註
CMenuTearOffManager::Initialize
BOOL Initialize(
LPCTSTR lpszRegEntry,
UINT uiTearOffMenuFirst,
UINT uiTearOffMenuLast);
參數
lpszRegEntry
[in]包含登錄項目路徑的字串。 您的應用程式會將卸除列的設定儲存在此登錄專案中。
uiTearOffMenuFirst
[in]卸除功能表的第一個功能表標識碼。
uiTearOffMenuLast
[in]卸除功能表的最後一個功能表標識碼。
傳回值
如果成功則為非零;否則為 0。
備註
從 uiTearOffMenuFirst 到 uiTearOffMenuLast 的功能表標識符範圍必須是連續間隔。 間隔會定義可以同時出現在應用程式中的卸除功能表數目。
CMenuTearOffManager::IsDynamicID
BOOL IsDynamicID(UINT uiID) const;
參數
[in] uiID
傳回值
備註
CMenuTearOffManager::P arse
UINT Parse(CString& str);
參數
[in] str
傳回值
備註
CMenuTearOffManager::Reset
void Reset(HMENU hmenu);
參數
[in] hmenu
備註
CMenuTearOffManager::SetInUse
void SetInUse(
UINT uiCmdId,
BOOL bUse = TRUE);
參數
[in] uiCmdId
[in] bUse
備註
CMenuTearOffManager::SetupTearOffMenus
void SetupTearOffMenus(HMENU hMenu);
參數
[in] hMenu