Compartir a través de


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

CObject

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

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CWinAppEx (clase)