Clase CMenuTearOffManager
Administra menús con barra desplazable. Un menú con barra desplazable es un menú de la barra de menús. El usuario puede quitar un menú con barra desplazable de la barra de menús y provocar que el menú con barra desplazable quede flotante.
Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.
Sintaxis
class CMenuTearOffManager : public CObject
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CMenuTearOffManager::CMenuTearOffManager | Construye un objeto CMenuTearOffManager. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CMenuTearOffManager::Build | |
| CMenuTearOffManager::GetRegPath | |
| CMenuTearOffManager::Initialize | Inicializa un objeto CMenuTearOffManager. |
| CMenuTearOffManager::IsDynamicID | |
| CMenuTearOffManager::Parse | |
| CMenuTearOffManager::Reset | |
| CMenuTearOffManager::SetInUse | |
| CMenuTearOffManager::SetupTearOffMenus |
Comentarios
Para usar menús con barra desplazable en una aplicación, es preciso tener un objeto CMenuTearOffManager. En la mayoría de los casos, los objetos CMenuTearOffManager no crearán ni se inicializarán directamente. Esto se controla automáticamente cuando se llama a la función CWinAppEx::EnableTearOffMenus.
Ejemplo
En el ejemplo siguiente se muestra cómo construir e inicializar un objeto CMenuTearOffManager mediante una llamada al método CWinAppEX::EnableTearOffMenus. Este fragmento de código forma parte del ejemplo de WordPad.
// The EnableTearOffMenus method is inherited from the CWinAppEx class.
EnableTearOffMenus(NULL, ID_FREE_TEAROFF1, ID_FREE_TEAROFF2);
Jerarquía de herencia
CMenuTearOffManager
Requisitos
Encabezado: afxmenutearoffmanager.h
CMenuTearOffManager::Build
void Build(
UINT uiTearOffBarID,
CString& strText);
Parámetros
[in] uiTearOffBarID
[in] strText
Comentarios
CMenuTearOffManager::CMenuTearOffManager
Construye un objeto CMenuTearOffManager.
CMenuTearOffManager();
Comentarios
En la mayoría de los casos, no debería crear manualmente un objeto CMenuTearOffManager. El marco de la aplicación crea el objeto CMenuTearOffManager al llamar a CWinAppEx::EnableTearOffMenus.
CMenuTearOffManager::GetRegPath
LPCTSTR GetRegPath() const;
Valor devuelto
Comentarios
CMenuTearOffManager::Initialize
Inicializa un objeto CMenuTearOffManager.
BOOL Initialize(
LPCTSTR lpszRegEntry,
UINT uiTearOffMenuFirst,
UINT uiTearOffMenuLast);
Parámetros
lpszRegEntry
[in] Cadena que contiene la ruta de acceso de una entrada del Registro. Las aplicaciones almacenan la configuración de barras desplazables en esta entrada del Registro.
uiTearOffMenuFirst
[in] El primer identificador de menú de un menú con barra desplazable.
uiTearOffMenuLast
[in] El último identificador de menú de un menú con barra desplazable.
Valor devuelto
Si es correcta, su valor es distinto de cero. En caso contrario, es cero.
Comentarios
El intervalo de identificadores de menú de uiTearOffMenuFirst a uiTearOffMenuLast debe ser un intervalo continuo. El intervalo define el número de menús con barras desplazables que pueden aparecer al mismo tiempo en la aplicación.
CMenuTearOffManager::IsDynamicID
BOOL IsDynamicID(UINT uiID) const;
Parámetros
[in] uiID
Valor devuelto
Comentarios
CMenuTearOffManager::Parse
UINT Parse(CString& str);
Parámetros
[in] str
Valor devuelto
Comentarios
CMenuTearOffManager::Reset
void Reset(HMENU hmenu);
Parámetros
[in] hmenu
Comentarios
CMenuTearOffManager::SetInUse
void SetInUse(
UINT uiCmdId,
BOOL bUse = TRUE);
Parámetros
[in] uiCmdId
[in] bUse
Comentarios
CMenuTearOffManager::SetupTearOffMenus
void SetupTearOffMenus(HMENU hMenu);
Parámetros
[in] hMenu