CMenuTearOffManager 類別

管理 Tear-Off 功能表。 Tear-Off 功能表是在功能表列上的功能表。 使用者可以取下功能表列中的 Tear-Off 功能表,讓 Tear-Off 功能表浮動。

如需更多詳細資料,請參閱 Visual Studio 安裝位置下之 VC\atlmfc\src\mfc 資料夾中的原始程式碼。

語法

class CMenuTearOffManager : public CObject

成員

公用建構函式

名稱 描述
CMenuTearOffManager::CMenuTearOffManager 建構 CMenuTearOffManager 物件。

公用方法

名稱 描述
CMenuTearOffManager::Build
CMenuTearOffManager::GetRegPath
CMenuTearOffManager::Initialize CMenuTearOffManager初始化物件。
CMenuTearOffManager::IsDynamicID
CMenuTearOffManager::P arse
CMenuTearOffManager::Reset
CMenuTearOffManager::SetInUse
CMenuTearOffManager::SetupTearOffMenus

備註

若要在應用程式中使用卸除功能表,您必須有 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);

繼承階層架構

CObject

CMenuTearOffManager

需求

標頭: afxmenutearoffmanager.h

CMenuTearOffManager::Build

void Build(
    UINT uiTearOffBarID,
    CString& strText);

參數

[in] uiTearOffBarID

[in] strText

備註

CMenuTearOffManager::CMenuTearOffManager

建構 CMenuTearOffManager 物件。

CMenuTearOffManager();

備註

在大部分情況下,您不應該手動建立 CMenuTearOffManager 。 當您呼叫 CWinAppEx::EnableTearOffMenus 時,CMenuTearOffManager應用程式的架構會建立 物件。

CMenuTearOffManager::GetRegPath

LPCTSTR GetRegPath() const;

傳回值

備註

CMenuTearOffManager::Initialize

初始化 CMenuTearOffManager 物件。

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

備註

另請參閱

階層架構圖表
類別
CWinAppEx 類別