CMenuTearOffManager クラス
ティアオフ メニューを管理します。 ティアオフ メニューはメニュー バー上のメニューの一種です。 ユーザーは、ティアオフ メニューをメニュー バーから外して、フローティング メニューにすることができます。
詳細については、Visual Studio のインストールの VC\atlmfc\src\mfc フォルダーにあるソース コードを参照してください。
構文
class CMenuTearOffManager : public CObject
メンバー
パブリック コンストラクター
| 名前 | 説明 |
|---|---|
| CMenuTearOffManager::CMenuTearOffManager | CMenuTearOffManager オブジェクトを構築します。 |
パブリック メソッド
解説
アプリケーションでティアオフ メニューを使用するには、 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);
継承階層
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