次の方法で共有


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 関数を呼び出すときに自動的に処理されます。

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

// The EnableTearOffMenus method is inherited from the CWinAppEx class.
EnableTearOffMenus(NULL, ID_FREE_TEAROFF1, ID_FREE_TEAROFF2);

継承階層

CObject

CMenuTearOffManager

要件

Header: afxmenutearoffmanager.h

CMenuTearOffManager::Build

void Build(
    UINT uiTearOffBarID,
    CString& strText);

パラメーター

[入力] uiTearOffBarID

[入力] 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;

パラメーター

[入力] uiID

戻り値

解説

CMenuTearOffManager::P arse

UINT Parse(CString& str);

パラメーター

[入力] str

戻り値

解説

CMenuTearOffManager::Reset

void Reset(HMENU hmenu);

パラメーター

[入力] hmenu

解説

CMenuTearOffManager::SetInUse

void SetInUse(
    UINT uiCmdId,
    BOOL bUse = TRUE);

パラメーター

[入力] uiCmdId

[入力] bUse

解説

CMenuTearOffManager::SetupTearOffMenus

void SetupTearOffMenus(HMENU hMenu);

パラメーター

[入力] hMenu

解説

関連項目

階層図
クラス
CWinAppEx クラス