Share via


CMenuTearOffManager クラス

ティアオフ メニューを管理します。 ティアオフ メニューはメニュー バー上のメニューの一種です。 ユーザーは、ティアオフ メニューをメニュー バーから外して、フローティング メニューにすることができます。

詳細については、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 関数を呼び出すときに自動的に処理されます。

次の例では、メソッドを呼び出してオブジェクトを CMenuTearOffManager 構築および初期化する方法を CWinAppEX::EnableTearOffMenus 示します。 このコード スニペットは、 Word パッド サンプルの一部です。

// 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]ティアオフ メニューの最初のメニュー ID。

uiTearOffMenuLast
[in]破棄メニューの最後のメニュー ID。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

uiTearOffMenuFirst から uiTearOffMenuLast までのメニュー ID の範囲は、連続する間隔である必要があります。 間隔は、アプリケーションで同時に表示できるティアオフ メニューの数を定義します。

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 クラス