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
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 retorno
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 retorno
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 retorno
Comentários
CMenuTearOffManager::Parse
UINT Parse(CString& str);
Parâmetros
[in] str
Valor de retorno
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