Класс CMenuTearOffManager

Замечание

Библиотека классов Microsoft Foundation (MFC) продолжает поддерживаться. Однако мы больше не добавляем функции или обновляем документацию.

Управление перемещаемыми меню. Перемещаемое меню — это меню в строке меню. Пользователь может удалить перемещаемое меню из строки меню, превращая перемещаемое меню в плавающее.

Дополнительные сведения см. в исходном коде, расположенном в папке VC\atlmfc\src\mfc установки Visual Studio.

Синтаксис

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 Pad.

// 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 вручную. Платформа приложения создает CMenuTearOffManager объект при вызове CWinAppEx::EnableTearOffMenus.

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] Ул

Возвращаемое значение

Замечания

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