Classe CMenuTearOffManager

Gerencia menus de desativação. Um menu de desativação é um menu na barra de menus. O usuário pode remover um menu de desativação da barra de menus, fazendo com que o menu de desativação flutue.

Para obter mais detalhes, confira o código-fonte localizado na pasta VC\atlmfc\src\mfc de sua instalação do Visual Studio.

Sintaxe

class CMenuTearOffManager : public CObject

Membros

Construtores públicos

Nome	Descrição
CMenuTearOffManager::CMenuTearOffManager	Constrói um objeto CMenuTearOffManager.

Métodos públicos

Nome	Descrição
CMenuTearOffManager::Build
CMenuTearOffManager::GetRegPath
CMenuTearOffManager::Initialize	Inicializa um objeto CMenuTearOffManager.
CMenuTearOffManager::IsDynamicID
CMenuTearOffManager::Parse
CMenuTearOffManager::Reset
CMenuTearOffManager::SetInUse
CMenuTearOffManager::SetupTearOffMenus

Comentários

Para usar menus de desativação no seu aplicativo, você deve ter um objeto CMenuTearOffManager. Na maioria dos casos, você não criará nem inicializará um objeto CMenuTearOffManager diretamente. Isso é feito para você quando você chama a função CWinAppEx::EnableTearOffMenus.

Exemplo

O exemplo a seguir demonstra como construir e inicializar um objeto CMenuTearOffManager chamando o método CWinAppEX::EnableTearOffMenus. Este snippet de código faz parte do exemplo do Word Pad.

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

Hierarquia de herança

CObject

CMenuTearOffManager

Requisitos

Cabeçalho: afxmenutearoffmanager.h

CMenuTearOffManager::Build

void Build(
    UINT uiTearOffBarID,
    CString& strText);

Parâmetros

[in] uiTearOffBarID

[in] strText

Comentários

CMenuTearOffManager::CMenuTearOffManager

Constrói um objeto CMenuTearOffManager.

CMenuTearOffManager();

Comentários

Na maioria dos casos, você não deve criar um CMenuTearOffManager manualmente. A estrutura do seu aplicativo cria o objeto CMenuTearOffManager quando você chama CWinAppEx::EnableTearOffMenus.

CMenuTearOffManager::GetRegPath

LPCTSTR GetRegPath() const;

Valor de Devolução

Comentários

CMenuTearOffManager::Initialize

Inicializa um objeto CMenuTearOffManager.

BOOL Initialize(
    LPCTSTR lpszRegEntry,
    UINT uiTearOffMenuFirst,
    UINT uiTearOffMenuLast);

Parâmetros

lpszRegEntry
[in] Uma cadeia de caracteres que contém o caminho de uma entrada de registro. Os seus aplicativos armazenam as configurações para barras de desativação nesta entrada de registro.

uiTearOffMenuFirst
[in] A primeira ID de menu para um menu de desativação.

uiTearOffMenuLast
[in] A última ID de menu para um menu de desativação.

Valor de Devolução

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

O intervalo de IDs de menu de uiTearOffMenuFirst a uiTearOffMenuLast deve ser um intervalo contínuo. O intervalo define o número de menus de desativação que podem aparecer ao mesmo tempo no aplicativo.

CMenuTearOffManager::IsDynamicID

BOOL IsDynamicID(UINT uiID) const;

Parâmetros

[in] uiID

Valor de Devolução

Comentários

CMenuTearOffManager::Parse

UINT Parse(CString& str);

Parâmetros

[in] str

Valor de Devolução

Comentários

CMenuTearOffManager::Reset

void Reset(HMENU hmenu);

Parâmetros

[in] hmenu

Comentários

CMenuTearOffManager::SetInUse

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

Parâmetros

[in] uiCmdId

[in] bUse

Comentários

CMenuTearOffManager::SetupTearOffMenus

void SetupTearOffMenus(HMENU hMenu);

Parâmetros

[in] hMenu

Comentários

Confira também

Gráfico da hierarquia
Classes
Classe CWinAppEx