Clase `CFrameWndEx`

Artículo
04/03/2023

Implementa la funcionalidad de una interfaz de un único documento (SDI) de Windows superpuesta o una ventana de marco emergente y proporciona miembros para administrar la ventana. Extiende la clase CFrameWnd.

Sintaxis

class CFrameWndEx : public CFrameWnd

Miembros

Métodos públicos

Nombre	Descripción
`CFrameWndEx::ActiveItemRecalcLayout`	Ajusta el diseño del elemento de cliente OLE y el área de cliente del marco.
`CFrameWndEx::AddDockSite`	Este método no se usa.
`CFrameWndEx::AddPane`	Registra una barra de control con el administrador de acoplamiento.
`CFrameWndEx::AdjustDockingLayout`	Recalcula el diseño de todos los paneles que se acoplan a la ventana de marco.
`CFrameWndEx::DelayUpdateFrameMenu`	Establece el menú del marco y, a continuación, lo actualiza cuando el procesamiento de comandos está inactivo.
`CFrameWndEx::DockPane`	Acopla el panel especificado a la ventana de marco.
`CFrameWndEx::DockPaneLeftOf`	Acopla un panel a la izquierda de otro panel.
`CFrameWndEx::EnableAutoHidePanes`	Habilita el modo de ocultación automática para los paneles cuando se acoplan en los lados especificados de la ventana de marco principal.
`CFrameWndEx::EnableDocking`	Habilita el acoplamiento de los paneles que pertenecen a la ventana de marco.
`CFrameWndEx::EnableFullScreenMainMenu`	Muestra u oculta el menú principal en modo de pantalla completa.
`CFrameWndEx::EnableFullScreenMode`	Habilita el modo de pantalla completa para la ventana de marco.
`CFrameWndEx::EnableLoadDockState`	Habilita o deshabilita la carga del estado de acoplamiento.
`CFrameWndEx::EnablePaneMenu`	Habilita o deshabilita el control automático del menú del panel.
`CFrameWndEx::GetActivePopup`	Devuelve un puntero al menú emergente mostrado actualmente.
`CFrameWndEx::GetDefaultResId`	Devuelve el id. de recurso que especificó cuando el marco cargó la ventana de marco.
`CFrameWndEx::GetDockingManager`	Recupera el objeto `CDockingManager` Class de la ventana de marco.
`CFrameWndEx::GetMenuBar`	Devuelve un puntero al objeto de barra de menú asociado a la ventana de marco.
`CFrameWndEx::GetPane`	Devuelve un puntero al panel que tiene el id. especificado.
`CFrameWndEx::GetRibbonBar`	Recupera el control de barra de la cinta de opciones para el marco.
`CFrameWndEx::GetTearOffBars`	Devuelve una lista de objetos de panel que están en un estado desplazable.
`CFrameWndEx::GetToolbarButtonToolTipText`	Llamado por el marco cuando la aplicación muestra la información sobre herramientas de un botón de la barra de herramientas.
`CFrameWndEx::InsertPane`	Registra un panel con el administrador de acoplamiento.
`CFrameWndEx::IsFullScreen`	Determina si la ventana de marco está en modo de pantalla completa.
`CFrameWndEx::IsMenuBarAvailable`	Determina si el puntero al objeto de barra de menú es válido.
`CFrameWndEx::IsPointNearDockSite`	Indica si el punto se encuentra en una zona de alineación.
`CFrameWndEx::IsPrintPreview`	Indica si la ventana de marco está en modo de versión preliminar de impresión.
`CFrameWndEx::LoadFrame`	Se llama a este método después de la construcción para crear la ventana de marco y cargar sus recursos.
`CFrameWndEx::NegotiateBorderSpace`	Implementa la negociación del borde del cliente OLE.
`CFrameWndEx::OnActivate`	El marco llama a este método cuando la entrada de usuario se cambia hacia o desde el marco.
`CFrameWndEx::OnActivateApp`	Llamado por el marco cuando se selecciona o se anula la selección de la aplicación.
`CFrameWndEx::OnChangeVisualManager`	Llamado por el marco cuando un cambio en el marco requiere un cambio en el administrador visual.
`CFrameWndEx::OnClose`	El marco llama a este método para cerrar el marco.
`CFrameWndEx::OnCloseDockingPane`	Llamado por el marco cuando el usuario hace clic en el botón Cerrar en un panel de acoplamiento.
`CFrameWndEx::OnCloseMiniFrame`	Llamado por el marco cuando el usuario hace clic en el botón Cerrar en una ventana minimarco flotante.
`CFrameWndEx::OnClosePopupMenu`	Lo llama el marco cuando un menú emergente activo procesa un mensaje `WM_DESTROY`.
`CFrameWndEx::OnCmdMsg`	Envía mensajes de comando.
`CFrameWndEx::OnContextHelp`	Llamado por el marco para mostrar ayuda relacionada con el contexto.
`CFrameWndEx::OnCreate`	Llamado por el marco después de crear el marco.
`CFrameWndEx::OnDestroy`	Llamado por el marco cuando se destruye el marco.
`CFrameWndEx::OnDrawMenuImage`	Llamado por el marco cuando la aplicación dibuja la imagen asociada a un elemento de menú.
`CFrameWndEx::OnDrawMenuLogo`	Llamado por el marco cuando un objeto `CMFCPopupMenu` procesa un mensaje `WM_PAINT`.
`CFrameWndEx::OnDWMCompositionChanged`	Llamado por el marco cuando la composición del Administrador de ventanas de escritorio (DWM) se ha habilitado o deshabilitado.
`CFrameWndEx::OnExitSizeMove`	Llamado por el marco cuando el marco deja de moverse o cambiar de tamaño.
`CFrameWndEx::OnGetMinMaxInfo`	Llamado por el marco cuando se cambia el tamaño del marco para establecer límites de dimensiones de ventana.
`CFrameWndEx::OnIdleUpdateCmdUI`	Llamado por el marco para actualizar la visualización del marco cuando el procesamiento de comandos está inactivo.
`CFrameWndEx::OnLButtonDown`	El marco llama a este método cuando el usuario presiona el botón izquierdo del mouse.
`CFrameWndEx::OnLButtonUp`	El marco llama a este método cuando el usuario suelta el botón izquierdo del mouse.
`CFrameWndEx::OnMenuButtonToolHitTest`	Llamado por el marco cuando un objeto `CMFCToolBarButton` procesa un mensaje `WM_NCHITTEST`.
`CFrameWndEx::OnMenuChar`	Llamado por el marco cuando se muestra un menú y el usuario presiona una tecla que no corresponde a un comando.
`CFrameWndEx::OnMouseMove`	El marco llama a este método cuando se mueve el puntero.
`CFrameWndEx::OnMoveMiniFrame`	Llamado por el marco cuando se mueve una ventana de panel.
`CFrameWndEx::OnNcActivate`	Llamado por el marco cuando el área que no es de cliente del marco debe ser redibujada para indicar un cambio en el estado activo.
`CFrameWndEx::OnNcCalcSize`	Llamado por el marco cuando hay que calcular el tamaño y la posición del área cliente.
`CFrameWndEx::OnNcHitTest`	Llamado por el marco cuando el puntero se mueve o cuando se presiona o suelta un botón del mouse.
`CFrameWndEx::OnNcMouseMove`	Llamado por el marco cuando el puntero se mueve en un área que no es de cliente.
`CFrameWndEx::OnNcPaint`	Llamado por el marco cuando se debe pintar el área que no es de cliente.
`CFrameWndEx::OnPaneCheck`	Llamado por el marco para controlar la visibilidad de un panel.
`CFrameWndEx::OnPostPreviewFrame`	Llamado por el marco cuando el usuario ha cambiado el modo de versión preliminar de impresión.
`CFrameWndEx::OnPowerBroadcast`	Llamado por el marco cuando se produce un evento de administración de energía.
`CFrameWndEx::OnSetMenu`	Llamado por el marco para sustituir el menú de la ventana de marco.
`CFrameWndEx::OnSetPreviewMode`	Llamado por el marco para establecer el modo de vista previa de impresión del marco.
`CFrameWndEx::OnSetText`	Llamado por el marco para establecer el texto de una ventana.
`CFrameWndEx::OnShowCustomizePane`	Llamado por el marco cuando se activa un panel de personalización rápida.
`CFrameWndEx::OnShowPanes`	Llamado por el marco para mostrar u ocultar paneles.
`CFrameWndEx::OnShowPopupMenu`	Llamado por el marco cuando se activa un menú emergente.
`CFrameWndEx::OnSize`	El marco llama a este método después de que cambie el tamaño del marco.
`CFrameWndEx::OnSizing`	El marco llama a este método cuando el usuario cambia el tamaño del marco.
`CFrameWndEx::OnSysColorChange`	Llamado por el marco cuando cambian los colores del sistema.
`CFrameWndEx::OnTearOffMenu`	Llamado por el marco cuando se activa un menú con barra desplazable.
`CFrameWndEx::OnToolbarContextMenu`	Llamado por el marco para crear un menú contextual de la barra de herramientas.
`CFrameWndEx::OnToolbarCreateNew`	El marco llama a este método para crear una nueva barra de herramientas.
`CFrameWndEx::OnToolbarDelete`	Llamado por el marco cuando se elimina una barra de herramientas.
`CFrameWndEx::OnUpdateFrameMenu`	Llamado por el marco para establecer el menú de marco.
`CFrameWndEx::OnUpdateFrameTitle`	El marco llama a este método para actualizar la barra de título de la ventana de marco.
`CFrameWndEx::OnUpdatePaneMenu`	Llamado por el marco para actualizar el menú del panel.
`CFrameWndEx::OnWindowPosChanged`	Llamado por el marco cuando el tamaño, la posición o el orden z del marco han cambiado debido a una llamada a un método de administración de ventanas.
`CFrameWndEx::PaneFromPoint`	Devuelve el panel de acoplamiento que contiene el punto especificado.
`CFrameWndEx::PreTranslateMessage`	Controla mensajes de ventana específicos antes de que se envíen.
`CFrameWndEx::RecalcLayout`	Ajusta el diseño del marco y sus ventanas secundarias.
`CFrameWndEx::RemovePaneFromDockManager`	Anula el registro de un panel y lo quita de la lista interna del administrador de acoplamiento.
`CFrameWndEx::SetDockState`	Restaura el diseño de acoplamiento al estado de acoplamiento almacenado en el registro.
`CFrameWndEx::SetPrintPreviewFrame`	Establece la ventana de marco de la vista previa de impresión.
`CFrameWndEx::SetupToolbarMenu`	Inserta comandos definidos por el usuario en un menú de la barra de herramientas.
`CFrameWndEx::ShowFullScreen`	Cambia el marco principal entre la pantalla completa y los modos normales.
`CFrameWndEx::ShowPane`	Muestra u oculta el panel especificado.
`CFrameWndEx::UpdateCaption`	Lo llama el marco para actualizar la barra de título de la ventana de marco.
[CFrameWndEx::WinHelp``](#winhelp)\|Invokes either the Ayuda relacionada con la aplicación o el contexto de WinHelp.

Ejemplo

En el ejemplo siguiente se muestra cómo heredar una clase de la clase CFrameWndEx. En el ejemplo se muestran las firmas de método en la subclase y cómo invalidar el método OnShowPopupMenu. Este fragmento de código forma parte del ejemplo de WordPad.

class CMainFrame : public CFrameWndEx
{
protected: // create from serialization only
   CMainFrame();
   DECLARE_DYNCREATE(CMainFrame)

   // Attributes
public:
   HICON m_hIconDoc;
   HICON m_hIconText;
   HICON m_hIconWrite;
   HICON GetIcon(int nDocType);

   // Operations
public:
   void UpdateMRUFilesList()
   {
      m_wndTaskPane.UpdateMRUFilesList();
   }

   void OnChangeLook();

   // Overrides
   // ClassWizard generated virtual function overrides
   //{{AFX_VIRTUAL(CMainFrame)
public:
   virtual void ActivateFrame(int nCmdShow = -1);
   virtual BOOL LoadFrame(UINT nIDResource,
                          DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
                          CWnd *pParentWnd = NULL,
                          CCreateContext *pContext = NULL);

protected:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual BOOL OnCommand(WPARAM wParam, LPARAM lParam);
   //}}AFX_VIRTUAL

   virtual BOOL OnShowPopupMenu(CMFCPopupMenu *pMenuPopup);
   virtual BOOL OnTearOffMenu(CMFCPopupMenu *pMenuPopup, CPane *pBar);

protected:
   void AdjustObjectSubmenu(CMFCPopupMenu *pMenuPopup);
   void AdjustColorsMenu(CMFCPopupMenu *pMenuPopup, UINT uiId);

   // Implementation
public:
   virtual ~CMainFrame();
#ifdef _DEBUG
   virtual void AssertValid() const;
   virtual void Dump(CDumpContext &dc) const;
#endif

public:
   CMFCMenuBar m_wndMenuBar;
   CMFCToolBar m_wndToolBar;
   CMFCStatusBar m_wndStatusBar;
   CFormatBar m_wndFormatBar;
   CRulerBar m_wndRulerBar;
   CTaskPane m_wndTaskPane;

protected: // control bar embedded members
   BOOL CreateMenuBar();
   BOOL CreateToolBar();
   BOOL CreateFormatBar();
   BOOL CreateStatusBar();
   BOOL CreateRulerBar();
   BOOL CreateTaskPane();

   // Generated message map functions
protected:
   //{{AFX_MSG(CMainFrame)
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);
   afx_msg void OnSysColorChange();
   afx_msg void OnSize(UINT nType, int cx, int cy);
   afx_msg void OnMove(int x, int y);
   afx_msg void OnHelpFinder();
   afx_msg void OnDropFiles(HDROP hDropInfo);
   afx_msg void OnFontChange();
   afx_msg BOOL OnQueryNewPalette();
   afx_msg void OnPaletteChanged(CWnd *pFocusWnd);
   afx_msg void OnDevModeChange(LPTSTR lpDeviceName);
   afx_msg void OnViewCustomize();
   afx_msg void OnViewFullScreen();
   //}}AFX_MSG
   afx_msg LRESULT OnBarState(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnOpenMsg(WPARAM wParam, LPARAM lParam);
   afx_msg LRESULT OnHelpCustomizeToolbars(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnStartCustomize(WPARAM wp, LPARAM lp);
   afx_msg LRESULT OnToolbarCreateNew(WPARAM, LPARAM);
   afx_msg LRESULT OnGetDocumentColors(WPARAM, LPARAM);
   afx_msg void OnDummy();
   afx_msg void OnAskQuestion();
   DECLARE_MESSAGE_MAP()
};

// CMainFrame is application-defined object of type CFrameWndEx
BOOL CMainFrame::OnShowPopupMenu(CMFCPopupMenu *pMenuPopup)
{
   BOOL bRes = CFrameWndEx::OnShowPopupMenu(pMenuPopup);

   if (pMenuPopup != NULL && !pMenuPopup->IsCustomizePane())
   {
      AdjustObjectSubmenu(pMenuPopup);
      AdjustColorsMenu(pMenuPopup, ID_CHAR_COLOR);
   }

   return bRes;
}

Jerarquía de herencia

Requisitos

Encabezadoafxframewndex.h:

`CFrameWndEx::ActiveItemRecalcLayout`

Ajusta el diseño del elemento de cliente OLE y el área de cliente del marco.

void ActiveItemRecalcLayout();

Comentarios

`CFrameWndEx::AddPane`

Registra una barra de control con el administrador de acoplamiento.

BOOL AddPane(
    CBasePane* pControlBar,
    BOOL bTail=TRUE);

Parámetros

pControlBar
[in] Panel de barra de control que se va a registrar.

bTail
[in] TRUE si desea agregar el panel de la barra de control al final de la lista; de lo contrario, FALSE.

Valor devuelto

TRUE si la barra de control se registró correctamente; de lo contrario, FALSE.

`CFrameWndEx::AdjustDockingLayout`

Recalcula el diseño de todos los paneles que se acoplan a la ventana de marco.

virtual void AdjustDockingLayout(HDWP hdwp=NULL);

Parámetros

hdwp
Manipulador de una estructura que contiene las posiciones de varias ventanas. .

Comentarios

El método BeginDeferWindowPos inicializa la estructura de hdwp.

`CFrameWndEx::DelayUpdateFrameMenu`

Establece el menú del marco y, a continuación, lo actualiza cuando el procesamiento de comandos está inactivo.

virtual void DelayUpdateFrameMenu(HMENU hMenuAlt);

Parámetros

hMenuAlt
[in] Manipulador para un menú alternativo.

Comentarios

`CFrameWndEx::DockPane`

Acopla el panel especificado a la ventana de marco.

void DockPane(
    CBasePane* pBar,
    UINT nDockBarID=0,
    LPCRECT lpRect=NULL);

Parámetros

pBar
[in] Puntero a la barra de control que se va a acoplar.

nDockBarID
[in] Id. del lado de la ventana de marco al que se va a acoplar.

lpRect
[in] Puntero a una estructura constante Rect que especifica la posición y el tamaño de la pantalla de la ventana.

Comentarios

El parámetro nDockBarID puede tener uno de los siguientes valores:

AFX_IDW_DOCKBAR_TOP
AFX_IDW_DOCKBAR_BOTTOM
AFX_IDW_DOCKBAR_LEFT
AFX_IDW_DOCKBAR_RIGHT

`CFrameWndEx::DockPaneLeftOf`

Acopla el panel especificado a la izquierda de otro panel.

BOOL DockPaneLeftOf(
    CPane* pBar,
    CPane* pLeftOf);

Parámetros

pBar
[in] Puntero al objeto de panel que se va a acoplar.

pLeftOf
[in] Puntero al panel a la izquierda del cual se acopla el panel especificado por pBar.

Valor devuelto

TRUE si pBar se acopla correctamente. De lo contrario, FALSE.

Comentarios

El método toma la barra de herramientas especificada por el parámetro pBar y la acopla en el lado izquierdo de la barra de herramientas especificada por el parámetro pLeftOf.

`CFrameWndEx::EnableAutoHidePanes`

Habilita el modo de ocultación automática para el panel cuando está acoplado al lado especificado de la ventana de marco principal.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parámetros

dwDockStyle
[in] Especifica el lado de la ventana de marco principal a la que se acopla el panel.

Valor devuelto

TRUE si el panel de una barra se acopla correctamente al lado de la ventana de marco especificado por dwDockStyle; de lo contrario, FALSE.

Comentarios

dwDockStyle puede tener uno de los valores siguientes:

CBRS_ALIGN_TOP: permite acoplar la barra de control a la parte superior del área cliente de una ventana de marco.
CBRS_ALIGN_BOTTOM: permite acoplar la barra de control a la parte inferior del área cliente de una ventana de marco.
CBRS_ALIGN_LEFT: permite acoplar la barra de control al lado izquierdo del área cliente de una ventana de marco.
CBRS_ALIGN_RIGHT: permite acoplar la barra de control al lado derecho del área cliente de una ventana de marco.

`CFrameWndEx::EnableDocking`

Habilita el acoplamiento de los paneles de la ventana de marco.

BOOL EnableDocking(DWORD dwDockStyle);

Parámetros

dwDockStyle
[in] Especifica el lado de la ventana de marco principal donde se acopla la barra de panel.

Valor devuelto

TRUE si un panel de barras se puede acoplar correctamente en el lado especificado. De lo contrario, FALSE.

Comentarios

El parámetro dwDockStyle puede tener uno de los siguientes valores:

CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM
CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT

`CFrameWndEx::EnableFullScreenMainMenu`

Muestra u oculta el menú principal en modo de pantalla completa.

void EnableFullScreenMainMenu(BOOL bEnableMenu);

Parámetros

bEnableMenu
[in] TRUE para mostrar el menú principal en modo de pantalla completa; de lo contrario, FALSE.

`CFrameWndEx::EnableFullScreenMode`

Habilita el modo de pantalla completa para la ventana de marco.

void EnableFullScreenMode(UINT uiFullScreenCmd);

Parámetros

uiFullScreenCmd
[in] Id. de un comando que habilita y deshabilita el modo de pantalla completa.

Comentarios

En el modo de pantalla completa, todas las barras de control de acoplamiento, las barras de herramientas y el menú están ocultos y se cambia el tamaño de la vista activa para ocupar la pantalla completa.

Al habilitar el modo de pantalla completa, debe especificar un id. del comando que habilita o deshabilita el modo de pantalla completa. Puede llamar a EnableFullScreenMode desde la función OnCreate del marco principal. Cuando se cambia una ventana de marco al modo de pantalla completa, el marco crea una barra de herramientas flotante con un botón que tiene el id. de comando especificado.

Si quiere conservar el menú principal en la pantalla, llame a CFrameWndEx::EnableFullScreenMainMenu.

`CFrameWndEx::EnableLoadDockState`

Habilita o deshabilita la carga del estado de acoplamiento.

void EnableLoadDockState(BOOL bEnable=TRUE);

Parámetros

bEnable
[in] TRUE para habilitar la carga del estado de acoplamiento, FALSE para deshabilitar la carga del estado de acoplamiento.

`CFrameWndEx::EnablePaneMenu`

Habilita o deshabilita el control automático del menú del panel.

void EnablePaneMenu(
    BOOL bEnable,
    UINT uiCustomizeCmd,
    const CString& strCustomizeLabel,
    UINT uiViewToolbarsMenuEntryID,
    BOOL bContextMenuShowsToolbarsOnly=FALSE,
    BOOL bViewMenuShowsToolbarsOnly=FALSE);

Parámetros

bEnable
[in] TRUE para habilitar el control automático de los menús emergentes de la barra de control; FALSE para deshabilitar el control automático de los menús emergentes de la barra de control.

uiCustomizeCmd
[in] Id. de comando del elemento de menú Personalizar.

strCustomizeLabel
[in] Etiqueta que se va a mostrar para el elemento de menú Personalizar

uiViewToolbarsMenuEntryID
[in] Identificador de un elemento de menú de la barra de herramientas que abre el menú emergente en la barra de control.

bContextMenuShowsToolbarsOnly
[in] Si es TRUE, el menú contextual de la barra de control muestra solo la lista de barras de herramientas. Si es FALSE, el menú muestra la lista de las barras de herramientas y las barras de acoplamiento.

bViewMenuShowsToolbarsOnly
[in] Si es TRUE, el menú de la barra de control muestra solo la lista de barras de herramientas. Si es FALSE, el menú muestra la lista de las barras de herramientas y las barras de acoplamiento.

`CFrameWndEx::GetActivePopup`

Devuelve un puntero al menú emergente mostrado actualmente.

CMFCPopupMenu* GetActivePopup() const;

Valor devuelto

Puntero al menú emergente mostrado actualmente; de lo contrario, NULL.

`CFrameWndEx::GetDefaultResId`

Devuelve el id. de recurso que especificó cuando el marco cargó la ventana de marco.

UINT GetDefaultResId() const;

Valor devuelto

Valor del id. de recurso que el usuario especificó cuando el marco cargó la ventana de marco. Cero si la ventana de marco no tiene una barra de menús.

`CFrameWndEx::GetDockingManager`

Recupera el objeto CDockingManager Class de la ventana de marco.

CDockingManager* GetDockingManager();

Valor devuelto

Puntero a la clase CDockingManager.

Comentarios

La ventana de marco crea y usa un objeto clase CDockingManager para administrar el acoplamiento de ventanas secundarias.

`CFrameWndEx::GetMenuBar`

Devuelve un puntero al objeto de barra de menú asociado a la ventana de marco.

const CMFCMenuBar* GetMenuBar() const;

Valor devuelto

Puntero al objeto de barra de menú asociado a la ventana de marco.

`CFrameWndEx::GetPane`

Devuelve un puntero al panel que tiene el id. especificado.

CBasePane* GetPane(UINT nID);

Parámetros

nID
[in] La id. del control.

Valor devuelto

Puntero al panel que tiene el id. especificado. NULL si no existe dicho panel.

`CFrameWndEx::GetRibbonBar`

Recupera el control de barra de la cinta de opciones para el marco.

CMFCRibbonBar* GetRibbonBar();

Valor devuelto

Puntero a la clase CMFCRibbonBar para el marco.

Comentarios

`CFrameWndEx::GetTearOffBars`

Devuelve una lista de objetos de panel que están en un estado desplazable.

const CObList& GetTearOffBars() const;

Valor devuelto

Referencia a objeto CObList que contiene una colección de punteros a objetos derivados del panel que están en estado desplazable.

`CFrameWndEx::GetToolbarButtonToolTipText`

Llamado por el marco cuando la aplicación muestra la información sobre herramientas de un botón de la barra de herramientas.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton* pButton,
    CString& strTTText);

Parámetros

pButton
[in] Puntero a un botón de la barra de herramientas.

strTTText
[in] Texto de la información sobre herramientas para el botón.

Valor devuelto

TRUE si se ha mostrado la información sobre herramientas. De lo contrario, FALSE.

Comentarios

De forma predeterminada, este método no hace nada. Invalide este método si desea mostrar la información sobre herramientas para el botón de la barra de herramientas.

`CFrameWndEx::InsertPane`

Inserta un panel en una lista de barras de control y lo registra con el administrador de acoplamiento.

BOOL InsertPane(
    CBasePane* pControlBar,
    CBasePane* pTarget,
    BOOL bAfter=TRUE);

Parámetros

pControlBar
Puntero a una barra de controles que se va a insertar en la lista de barras de control y a registrar con el administrador de acoplamiento.

pTarget
Puntero a una barra de control antes o después de la que se va a insertar el panel.

bAfter
TRUE si desea insertar pControlBar después de pTarget; de lo contrario, FALSE.

Valor devuelto

TRUEsi la barra de control se insertó y registró correctamente; de lo contrario, FALSE.

Comentarios

Cada barra de control debe registrarse mediante la clase CDockingManager para formar parte del diseño de acoplamiento.

`CFrameWndEx::IsFullScreen`

Determina si la ventana de marco está en modo de pantalla completa.

BOOL IsFullScreen() const;

Valor devuelto

TRUE si la ventana de marco está en modo de pantalla completa; de lo contrario, FALSE.

Comentarios

Puede establecer el modo de pantalla completa llamando al método CFrameWndEx::EnableFullScreenMode.

`CFrameWndEx::IsMenuBarAvailable`

Determina si el puntero al objeto de barra de menú es válido.

BOOL IsMenuBarAvailable() const;

Valor devuelto

TRUE si la ventana de marco no tiene ninguna barra de menús; de lo contrario, FALSE.

`CFrameWndEx::IsPointNearDockSite`

Determina si el punto se encuentra en una zona de alineación.

BOOL IsPointNearDockSite(
    CPoint point,
    DWORD& dwBarAlignment,
    BOOL& bOuterEdge) const;

Parámetros

point
[in] Posición del punto.

dwBarAlignment
[out] Donde se alinea el punto. Consulte la tabla en la sección Comentarios para ver los valores posibles.

bOuterEdge
[out] TRUE si el punto se encuentra cerca del borde del marco; FALSE si el punto se encuentra en un área de cliente.

Valor devuelto

TRUE si el punto se encuentra en una zona de alineación; de lo contrario, FALSE.

Comentarios

En la siguiente tabla se muestran los posibles valores del parámetro dwBarAlignment.

Valor	Descripción
`CBRS_ALIGN_TOP`	Alineado en la parte superior.
`CBRS_ALIGN_RIGHT`	Alineado a la derecha.
`CBRS_ALIGN_BOTTOM`	Alineado en la parte inferior.
`CBRS_ALIGN_LEFT`	Alineado a la izquierda.

`CFrameWndEx::IsPrintPreview`

Determina si la ventana de marco está en modo de versión preliminar de impresión.

BOOL IsPrintPreview();

Valor devuelto

TRUE si la ventana de marco está en modo de versión preliminar de impresión; de lo contrario, FALSE.

Comentarios

`CFrameWndEx::LoadFrame`

Se llama a este método después de la construcción para crear la ventana de marco y cargar sus recursos.

virtual BOOL LoadFrame(
    UINT nIDResource,
    DWORD dwDefaultStyle = WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,
    CWnd* pParentWnd = NULL,
    CCreateContext* pContext = NULL);

Parámetros

nIDResource
[in] Id. de recurso que se usa para cargar todos los recursos de marco.

dwDefaultStyle
[in] Estilo de ventana de marco predeterminado.

pParentWnd
[in] Puntero a la ventana primaria del marco.

pContext
[in] Puntero a una Estructura CCreateContext que usa el marco durante la creación de la aplicación.

Valor devuelto

Es TRUE si el método es correcto; en caso contrario, es FALSE.

Comentarios

`CFrameWndEx::NegotiateBorderSpace`

Implementa la negociación del borde del cliente OLE.

virtual BOOL NegotiateBorderSpace(
    UINT nBorderCmd,
    LPRECT lpRectBorder);

Parámetros

nBorderCmd
[in] Comando de negociación de borde. Consulte la sección Comentarios para ver los valores posibles.

lpRectBorder
[in, out] Dimensiones del borde.

Valor devuelto

TRUE si se debe volver a calcular el diseño; de lo contrario, FALSE.

Comentarios

En la siguiente tabla se muestran los posibles valores del parámetro nBorderCmd.

borderGet
Obtener espacio de cliente OLE disponible.

borderRequest
Solicitar espacio de cliente OLE.

borderSet
Solicitar espacio de cliente OLE.

`CFrameWndEx::OnActivate`

El marco llama a este método cuando la entrada de usuario se cambia hacia o desde el marco.

afx_msg void OnActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parámetros

nState
[in] Si el marco está activo o inactivo. Consulte la tabla en la sección Comentarios para ver los valores posibles.

pWndOther
[in] Puntero a otra ventana que cambia la entrada del usuario con la actual.

bMinimized
[in] Estado minimizado del marco. TRUE si el marco está minimizado; de lo contrario, FALSE.

Comentarios

En la siguiente tabla se muestran los posibles valores del parámetro nState.

Valor	Descripción
`WA_ACTIVE`	El marco se selecciona mediante un método distinto de un clic del mouse.
`WA_CLICKACTIVE`	El marco se selecciona mediante un clic del mouse.
`WA_INACTIVE`	El marco no está seleccionado.

`CFrameWndEx::OnActivateApp`

Llamado por el marco cuando se selecciona o se anula la selección de la aplicación.

afx_msg void OnActivateApp(
    BOOL bActive,
    DWORD dwThreadID);

Parámetros

bActive
[in] TRUE si la aplicación está seleccionada; FALSE si la aplicación no está seleccionada.

dwThreadID
[in] Este parámetro no se usa.

Comentarios

`CFrameWndEx::OnChangeVisualManager`

Llamado por el marco cuando un cambio en el marco requiere un cambio en el administrador visual.

afx_msg LRESULT OnChangeVisualManager(
    WPARAM wParam,
    LPARAM lParam);

Parámetros

wParam
[in] Este parámetro no se usa.

lParam
[in] Este parámetro no se usa.

Valor devuelto

Siempre devuelve 0.

Comentarios

`CFrameWndEx::OnClose`

El marco llama a este método para cerrar el marco.

afx_msg void OnClose();

Comentarios

Si el marco está en modo de versión preliminar de impresión, envía un mensaje de Windows para cerrar la versión preliminar de impresión; de lo contrario, si el marco hospeda un cliente OLE, el cliente se desactiva.

`CFrameWndEx::OnCloseDockingPane`

Llamado por el marco cuando el usuario hace clic en el botón Cerrar en un panel de acoplamiento.

virtual BOOL OnCloseDockingPane(CDockablePane* pPane);

Valor devuelto

TRUE si se puede cerrar la barra de acoplamiento; de lo contrario, FALSE

Comentarios

La implementación predeterminada no hace nada. Invalide este método si desea controlar la ocultación de la barra de acoplamiento.

`CFrameWndEx::OnCloseMiniFrame`

Llamado por el marco cuando el usuario hace clic en el botón Cerrar en una ventana minimarco flotante.

virtual BOOL OnCloseMiniFrame(CPaneFrameWnd* pWnd);

Valor devuelto

TRUE si se puede cerrar la ventana minimarco flotante. De lo contrario, FALSE.

Comentarios

La implementación predeterminada no hace nada. Invalide este método si desea procesar la ocultación de una ventana minimarco flotante.

`CFrameWndEx::OnClosePopupMenu`

Lo llama el marco cuando un menú emergente activo procesa un mensaje WM_DESTROY.

virtual void OnClosePopupMenu(CMFCPopupMenu* pMenuPopup);

Parámetros

pMenuPopup
Puntero a un menú emergente.

Comentarios

El marco envía un mensaje WM_DESTROY cuando está a punto de cerrar la ventana. Invalide este método si desea controlar las notificaciones de los objetos CMFCPopupMenu que pertenecen a la ventana de marco cuando un objeto CMFCPopupMenu está procesando un mensaje WM_DESTROY enviado por el marco cuando se cierra la ventana.

`CFrameWndEx::OnCmdMsg`

Envía mensajes de comando.

virtual BOOL OnCmdMsg(
    UINT nID,
    int nCode,
    void* pExtra,
    AFX_CMDHANDLERINFO* pHandlerInfo);

Parámetros

nID
[in] Identificador del comando.

nCode
[in] Categoría de mensaje de comando.

pExtra
[in, out] Puntero a un objeto de comando.

pHandlerInfo
[in, out] Puntero a una estructura de controlador de comandos.

Valor devuelto

TRUE si se ha controlado el mensaje de comando; de lo contrario, FALSE.

Comentarios

`CFrameWndEx::OnContextHelp`

Llamado por el marco para mostrar ayuda relacionada con el contexto.

afx_msg void OnContextHelp();

Comentarios

`CFrameWndEx::OnCreate`

Llamado por el marco después de crear el marco.

afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

Parámetros

lpCreateStruct
[in] Puntero a la estructura CREATESTRUCT del nuevo marco.

Valor devuelto

0 para continuar con la creación del marco; -1 para destruir el marco.

Comentarios

`CFrameWndEx::OnDestroy`

Llamado por el marco cuando se destruye el marco.

afx_msg void OnDestroy();

Comentarios

La tabla de aceleración y todas las ventanas se destruyen.

`CFrameWndEx::OnDrawMenuImage`

Llamado por el marco cuando la aplicación dibuja la imagen asociada a un elemento de menú.

virtual BOOL OnDrawMenuImage(
    CDC* pDC,
    const CMFCToolBarMenuButton* pMenuButton,
    const CRect& rectImage);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

pMenuButton
[in] Puntero a un botón de menú cuya imagen se representa.

rectImage
[in] Puntero a una estructura Rect que especifica la posición de pantalla y el tamaño de la imagen.

Valor devuelto

TRUE si el marco representa correctamente la imagen; de lo contrario, FALSE.

Comentarios

Invalide este método si desea personalizar la representación de imágenes para los elementos de menú que pertenecen a la barra de menús propiedad del objeto derivado de CFrameWndEx.

`CFrameWndEx::OnDrawMenuLogo`

Llamado por el marco cuando un objeto CMFCPopupMenu procesa un mensaje WM_PAINT.

virtual void OnDrawMenuLogo(
    CDC* pDC,
    CMFCPopupMenu* pMenu,
    const CRect& rectLogo);

Parámetros

pDC
[in] Puntero a un contexto de dispositivo.

pMenu
[in] Puntero al elemento de menú.

rectLogo
[in] Referencia a una estructura CRect constante que especifica la posición y el tamaño de la pantalla del logotipo del menú.

Comentarios

Invalide esta función si desea mostrar un logotipo en el menú emergente que pertenece a la barra de menús propiedad del objeto derivado de CFrameWndEx.

`CFrameWndEx::OnDWMCompositionChanged`

Llamado por el marco cuando la composición del Administrador de ventanas de escritorio (DWM) se ha habilitado o deshabilitado.

afx_msg LRESULT OnDWMCompositionChanged(
    WPARAM wp,
    LPARAM lp);

Parámetros

wp
[in] Este parámetro no se usa.

lp
[in] Este parámetro no se usa.

Valor devuelto

Siempre devuelve 0.

Comentarios

`CFrameWndEx::OnExitSizeMove`

Llamado por el marco cuando el marco deja de moverse o cambiar de tamaño.

LRESULT OnExitSizeMove(
    WPARAM wp,
    LPARAM lp);

Parámetros

wp
[in] Este parámetro no se usa.

lp
[in] Este parámetro no se usa.

Valor devuelto

Siempre devuelve 0.

Comentarios

`CFrameWndEx::OnGetMinMaxInfo`

Llamado por el marco cuando se cambia el tamaño del marco para establecer límites de dimensiones de ventana.

afx_msg void OnGetMinMaxInfo(MINMAXINFO FAR* lpMMI);

Parámetros

lpMMI
[in] Puntero a una MINMAXINFO estructura.

Comentarios

`CFrameWndEx::OnIdleUpdateCmdUI`

Llamado por el marco para actualizar la visualización del marco cuando el procesamiento de comandos está inactivo.

afx_msg LRESULT OnIdleUpdateCmdUI(
    WPARAM wParam = 0,
    LPARAM lParam = 0);

Parámetros

wParam
[in] Este parámetro no se usa.

lParam
[in] Este parámetro no se usa.

Valor devuelto

Siempre devuelve 0.

Comentarios

`CFrameWndEx::OnLButtonDown`

El marco llama a este método cuando el usuario presiona el botón izquierdo del mouse.

afx_msg void OnLButtonDown(
    UINT nFlags,
    CPoint point);

Parámetros

nFlags
[in] Indica si el usuario presionó las teclas modificadoras. Para conocer los valores posibles, consulte el parámetro wParam en la notificación WM_LBUTTONDOWN.

point
[in] Especifica las coordenadas X e Y del puntero, relativas a la esquina superior izquierda de la ventana.

Comentarios

`CFrameWndEx::OnLButtonUp`

El marco llama a este método cuando el usuario suelta el botón izquierdo del mouse.

afx_msg void OnLButtonUp(
    UINT nFlags,
    CPoint point);

Parámetros

nFlags
[in] Indica si el usuario presionó las teclas modificadoras. Para conocer los valores posibles, consulte el parámetro wParam en la notificación WM_LBUTTONUP.

point
[in] Especifica las coordenadas X e Y del puntero, relativas a la esquina superior izquierda de la ventana.

Comentarios

`CFrameWndEx::OnMenuButtonToolHitTest`

Llamado por el marco cuando un objeto CMFCToolBarButton procesa un mensaje WM_NCHITTEST.

virtual BOOL OnMenuButtonToolHitTest(
    CMFCToolBarButton* pButton,
    TOOLINFO* pTI);

Parámetros

pButton
[in] Puntero al botón de la barra de herramientas.

pTI
[out] Puntero a una estructura de información de herramientas.

Valor devuelto

TRUE si la aplicación rellena el parámetro pTI. De lo contrario, FALSE.

Comentarios

Invalide este método si quiere proporcionar información sobre un elemento específico del menú.

`CFrameWndEx::OnMenuChar`

Llamado por el marco cuando se muestra un menú y el usuario presiona una tecla que no corresponde a un comando.

afx_msg LRESULT OnMenuChar(
    UINT nChar,
    UINT nFlags,
    CMenu* pMenu);

Parámetros

nChar
[in] Código de caracteres de la tecla presionada.

nFlags
[in] Contiene la marca MF_POPUP si el menú mostrado es un submenú; contiene la marca MF_SYSMENU si el menú mostrado es un menú de control.

pMenu
[in] Puntero a un menú.

Valor devuelto

La palabra de orden superior debe tener uno de los siguientes valores.

Valor	Descripción
`0`	El marco debe ignorar la pulsación de la tecla.
`1`	El marco debe cerrar el menú.
`2`	El marco debe seleccionar uno de los elementos que se muestran en el menú. La palabra de orden inferior contiene el id. del comando que se va a seleccionar.

`CFrameWndEx::OnMouseMove`

El marco llama a este método cuando se mueve el puntero.

afx_msg void OnMouseMove(
    UINT nFlags,
    CPoint point);

Parámetros

nFlags
[in] Indica si el usuario presionó las teclas modificadoras. Para conocer los valores posibles, consulte el parámetro wParam en la notificación WM_MOUSEMOVE.

point
[in] Especifica las coordenadas x e y del puntero, relativas a la esquina superior izquierda de la ventana.

Comentarios

`CFrameWndEx::OnMoveMiniFrame`

Llamado por el marco cuando se mueve una ventana de panel.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parámetros

pFrame
[in] Puntero a la ventana del panel Clase CPaneFrameWnd.

Valor devuelto

TRUE si la ventana del panel no estaba acoplada; FALSE si la ventana del panel estaba acoplada.

Comentarios

`CFrameWndEx::OnNcActivate`

Llamado por el marco cuando el área que no es de cliente del marco debe ser redibujada para indicar un cambio en el estado activo.

afx_msg BOOL OnNcActivate(BOOL bActive);

Parámetros

bActive
[in] TRUE para dibujar el marco activo; FALSE para dibujar el marco inactivo.

Valor devuelto

Distinto de cero para continuar con el procesamiento predeterminado; 0 para evitar que se desactive el área que no es de cliente.

Comentarios

`CFrameWndEx::OnNcCalcSize`

Llamado por el marco cuando hay que calcular el tamaño y la posición del área cliente.

afx_msg void OnNcCalcSize(
    BOOL bCalcValidRects,
    NCCALCSIZE_PARAMS FAR* lpncsp);

Parámetros

bCalcValidRects
[in] TRUE cuando la aplicación debe especificar un área cliente válida; de lo contrario, FALSE.

lpncsp
[in] Puntero a una estructura NCCALCSIZE_PARAMS que contiene cambios en la dimensión de marco.

Comentarios

`CFrameWndEx::OnNcHitTest`

Llamado por el marco cuando el puntero se mueve o cuando se presiona o suelta un botón del mouse.

afx_msg LRESULT OnNcHitTest(CPoint point);

Parámetros

point
[in] Ubicación del puntero en coordenadas de pantalla.

Valor devuelto

Valor enumerado de aciertos de puntero. Para una lista de valores posibles, consulte Notificación WM_NCHITTEST.

Comentarios

`CFrameWndEx::OnNcMouseMove`

Llamado por el marco cuando el puntero se mueve en un área que no es de cliente.

afx_msg void OnNcMouseMove(
    UINT nHitTest,
    CPoint point);

Parámetros

nHitTest
[in] Valor enumerado de aciertos de puntero. Para una lista de valores posibles, consulte Notificación WM_NCHITTEST.

point
[in] Ubicación del puntero en coordenadas de pantalla.

Comentarios

`CFrameWndEx::OnNcPaint`

Llamado por el marco cuando se debe pintar el área que no es de cliente.

afx_msg void OnNcPaint();

Comentarios

`CFrameWndEx::OnPaneCheck`

Llamado por el marco para controlar la visibilidad de un panel.

afx_msg BOOL OnPaneCheck(UINT nID);

Parámetros

nID
[in] Id. de control de un panel.

Valor devuelto

TRUE si se ha controlado el comando; FALSE para continuar con el procesamiento de comandos.

Comentarios

`CFrameWndEx::OnPostPreviewFrame`

Llamado por el marco cuando el usuario cambia el modo de versión preliminar de impresión.

afx_msg LRESULT OnPostPreviewFrame(
    WPARAM wParam,
    LPARAM lParam);

Parámetros

wParam
[in] Este parámetro no se usa.

lParam
[in] TRUE cuando el marco está en modo de versión preliminar de impresión; FALSE cuando el modo de versión preliminar de impresión está desactivado.

Valor devuelto

Siempre devuelve 0.

Comentarios

`CFrameWndEx::OnPowerBroadcast`

Llamado por el marco cuando se produce un evento de administración de energía.

afx_msg LRESULT OnPowerBroadcast(
    WPARAM wp,
    LPARAM lp);

Parámetros

wp
[entrada] Un evento de administración de energía. Para una lista de valores posibles, consulte Mensaje WM_POWERBROADCAST.

lp
[in] Este parámetro no se usa.

Valor devuelto

Resultado de llamar al procedimiento de ventana predeterminado.

Comentarios

`CFrameWndEx::OnSetMenu`

Llamado por el marco para sustituir el menú de la ventana de marco.

afx_msg LRESULT OnSetMenu(
    WPARAM wp,
    LPARAM lp);

BOOL OnSetMenu(HMENU hmenu);

Parámetros

wp
[in] Manipulador del nuevo menú de ventana de marco.

lp
[in] Manipulador del nuevo menú de ventana.

hmenu
[in] Manipulador del nuevo menú de ventana de marco.

Valor devuelto

LRESULT es el resultado de llamar al procedimiento de ventana predeterminado.

BOOL es TRUE si se ha controlado el evento; de lo contrario, es FALSE.

Comentarios

`CFrameWndEx::OnSetPreviewMode`

Llamado por el marco para establecer el modo de vista previa de impresión del marco.

virtual void OnSetPreviewMode(
    BOOL bPreview,
    CPrintPreviewState* pState);

Parámetros

bPreview
[in] TRUE para habilitar la versión preliminar de impresión; FALSE para deshabilitar la versión preliminar de impresión.

pState
[in] Puntero a una estructura de estado de marco CPrintPreviewState.

Comentarios

`CFrameWndEx::OnSetText`

Llamado por el marco para establecer el texto de una ventana.

afx_msg LRESULT OnSetText(
    WPARAM wParam,
    LPARAM lParam);

Parámetros

wParam
[in] Este parámetro no se usa.

lParam
[in] Puntero al texto sobre la ventana.

Valor devuelto

Valor devuelto de una llamada a DefWindowProc.

Comentarios

`CFrameWndEx::OnShowCustomizePane`

Llamado por el marco cuando muestra un QuickCustomizePane.

virtual BOOL OnShowCustomizePane(
    CMFCPopupMenu* pMenuPane,
    UINT uiToolbarID);

Parámetros

pMenuPane
[in] Puntero al panel de personalización rápida.

uiToolbarID
[in] Id. de control de la barra de herramientas que se va a personalizar.

Valor devuelto

Este método devuelve siempre TRUE.

Comentarios

El menú personalizar rápido es un menú emergente que aparece al hacer clic en el botón personalizar de la barra de herramientas.

`CFrameWndEx::OnShowPanes`

Llamado por el marco para mostrar u ocultar paneles.

virtual BOOL OnShowPanes(BOOL bShow);

Parámetros

bShow
[in] TRUE si la aplicación muestra los paneles; de lo contrario, FALSE.

Valor devuelto

Este método devuelve siempre FALSE.

Comentarios

La implementación predeterminada muestra los paneles si bShow es TRUE y los paneles están ocultos o cuando bShow es FALSE y los paneles están visibles.

La implementación predeterminada oculta los paneles si bShow es TRUE y los paneles están visibles o cuando bShow es FALSE y los paneles están ocultos.

Invalide este método en una clase derivada para ejecutar código personalizado cuando el marco muestra u oculta los paneles.

`CFrameWndEx::OnShowPopupMenu`

Lo llama el marco cuando muestra un menú emergente.

virtual BOOL OnShowPopupMenu(CMFCPopupMenu* pMenu);

Parámetros

pMenu
[in] Puntero a un menú emergente.

Valor devuelto

TRUE si el menú emergente está visible; de lo contrario, FALSE.

Comentarios

Invalide este método en una clase derivada para ejecutar código personalizado cuando el marco muestra un menú emergente. Por ejemplo, invalide este método para cambiar el color de fondo de los comandos en un menú emergente.

`CFrameWndEx::OnSize`

Llamado por el marco después de cambiar el tamaño del marco.

afx_msg void OnSize(
    UINT nType,
    int cx,
    int cy);

Parámetros

nType
[in] Tipo de cambio de tamaño. Para conocer los valores posibles, consulte el parámetro wParam en la notificación WM_SIZE.

cx
[in] Nuevo ancho del marco en píxeles.

cy
[in] Nuevo alto del marco en píxeles.

Comentarios

`CFrameWndEx::OnSizing`

Llamado por el marco cuando el usuario cambia el tamaño del marco.

afx_msg void OnSizing(
    UINT fwSide,
    LPRECT pRect);

Parámetros

fwSide
[in] Borde del marco que se ha movido. Consulte el parámetro wParam en la notificación WM_SIZING.

pRect
[in, out] Puntero a una estructura CRect o RECT que contiene las coordenadas del marco.

Comentarios

`CFrameWndEx::OnSysColorChange`

Llamado por el marco cuando cambian los colores del sistema.

void OnSysColorChange();

Comentarios

`CFrameWndEx::OnTearOffMenu`

Llamado por el marco cuando la aplicación muestra un menú con barra desplazable.

virtual BOOL OnTearOffMenu(
    CMFCPopupMenu* pMenuPopup,
    CPane* pBar);

Parámetros

pMenuPopup
[in] Puntero a un menú emergente.

pBar
[in] Puntero a la barra desplazable.

Valor devuelto

TRUE si el menú emergente con la barra de desmontaje está habilitado; de lo contrario, FALSE.

Comentarios

Invalide este método en una clase derivada para ejecutar código personalizado cuando el marco muestra una barra de control.

La implementación predeterminada no hace nada y devuelve TRUE.

`CFrameWndEx::OnToolbarContextMenu`

Llamado por el marco para crear un menú emergente de la barra de herramientas.

afx_msg LRESULT OnToolbarContextMenu(
    WPARAM wp,
    LPARAM lp);

Parámetros

wp
[in] Este parámetro no se usa.

lp
[in] Este parámetro no se usa.

Valor devuelto

Siempre devuelve 1.

Comentarios

`CFrameWndEx::OnToolbarCreateNew`

El marco llama a este método para crear una nueva barra de herramientas.

afx_msg LRESULT OnToolbarCreateNew(
    WPARAM wp,
    LPARAM lp);

Parámetros

wp
[in] Este parámetro no se usa.

lp
[in] Puntero al texto de la barra de título de la barra de herramientas.

Valor devuelto

Puntero a la nueva barra de herramientas; o NULL si no se ha creado una barra de herramientas.

Comentarios

`CFrameWndEx::OnToolbarDelete`

Llamado por el marco cuando se elimina una barra de herramientas.

afx_msg LRESULT OnToolbarDelete(
    WPARAM /* unused */,
    LPARAM lp);

`CFrameWndEx::PaneFromPoint`

Busca en cada panel el punto especificado.

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    bool bExactBar,
    CRuntimeClass* pRTCBarType) const;

CBasePane* PaneFromPoint(
    CPoint point,
    int nSensitivity,
    DWORD& dwAlignment,
    CRuntimeClass* pRTCBarType) const;

Parámetros

point
[in] Coordenadas de pantalla del punto que se va a comprobar.

nSensitivity
[in] Expanda el rectángulo delimitador de cada barra de control en esta cantidad cuando busque un punto.

bExactBar
[in] TRUE para pasar por alto el parámetro nSensitivity; en caso contrario, FALSE.

pRTCBarType
[in] Si no es NULL, el método solo busca barras de control del tipo especificado.

dwAlignment
[out] Si se ejecuta correctamente, este parámetro contiene el lado de la barra de control que está más cerca del punto especificado. En caso contrario, este parámetro no se inicializa.

Valor devuelto

Puntero a una barra de control que contiene el point; NULL si no se encuentra ningún control.

Comentarios

Este método busca un point en todas las barras de control de la aplicación.

Use nSensitivity para aumentar el tamaño del área de búsqueda. Use pRTCBarType para restringir los tipos de barras de control que busca el método.

`CFrameWndEx::PreTranslateMessage`

Controla mensajes de ventana específicos antes de que se envíen.

virtual BOOL PreTranslateMessage(MSG* pMsg);

Parámetros

pMsg
[in] Puntero a una estructura MSG que contiene el mensaje que se va a procesar.

Valor devuelto

Distinto de cero si el mensaje se controló y no se debe enviar; 0 si el mensaje no se ha controlado y se debe enviar.

Comentarios

`CFrameWndEx::RecalcLayout`

Ajusta el diseño del marco y sus ventanas secundarias.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parámetros

bNotify
[in] Especifica si se debe notificar al elemento de cliente OLE sobre el cambio de diseño.

Comentarios

Se llama a este método cuando el tamaño de la ventana de marco ha cambiado o cuando se muestran u ocultan las barras de control.

`CFrameWndEx::RemovePaneFromDockManager`

Anula el registro de un panel y lo quita del administrador de acoplamiento.

void RemovePaneFromDockManager(
    CBasePane* pControlBar,
    BOOL bDestroy,
    BOOL bAdjustLayout,
    BOOL bAutoHide,
    CBasePane* pBarReplacement);

Parámetros

pControlBar
[in] Puntero al panel de la barra de control que se va a quitar.

bDestroy
[in] TRUE para destruir la barra de control después de quitarla; de lo contrario, FALSE.

bAdjustLayout
[in] TRUE para ajustar el diseño de acoplamiento; de lo contrario, FALSE.

bAutoHide
[in] TRUE si la barra de control está en modo de ocultación automática; de lo contrario, FALSE.

pBarReplacement
[in] Puntero a un panel que reemplaza al panel quitado.

Comentarios

Utilice este método para quitar una barra de control del diseño de acoplamiento de la ventana de marco.

La clase CDockingManager controla el diseño de las barras de control. Debe registrar cada barra de control con el administrador de acoplamiento mediante el método CFrameWndEx::AddPane o el método CFrameWndEx::InsertPane.

`CFrameWndEx::SetDockState`

Restaura el diseño de acoplamiento al estado de acoplamiento almacenado en el registro.

void SetDockState(const CDockState& state);

Parámetros

state
Estado de acoplamiento. Este parámetro se ignora.

`CFrameWndEx::SetPrintPreviewFrame`

Establece la ventana de marco de la vista previa de impresión.

void SetPrintPreviewFrame(CFrameWnd* pWnd);

Parámetros

pWnd
[in] Puntero a una ventana de marco de versión preliminar de impresión.

Comentarios

`CFrameWndEx::SetupToolbarMenu`

Inserta comandos definidos por el usuario en un menú de la barra de herramientas.

void SetupToolbarMenu(
    CMenu& menu,
    const UINT uiViewUserToolbarCmdFirst,
    const UINT uiViewUserToolbarCmdLast);

Parámetros

menu
[in] Objeto CMenu que se va a modificar.

uiViewUserToolbarCmdFirst
[in] Primer comando definido por el usuario.

uiViewUserToolbarCmdLast
[in] Último comando definido por el usuario.

Comentarios

El marco almacena los comandos definidos por el usuario en una lista. Use uiViewUserToolbarCmdFirst y uiViewUserToolbarCmdList para especificar los índices de los comandos que se van a insertar.

`CFrameWndEx::ShowFullScreen`

Cambia el marco principal entre el modo de pantalla completa y el modo normal.

void ShowFullScreen();

`CFrameWndEx::ShowPane`

Muestra u oculta el panel especificado.

void ShowPane(
    CBasePane* pBar,
    BOOL bShow,
    BOOL bDelay,
    BOOL bActivate);

Parámetros

pBar
[in] Puntero a la barra de control que se va a mostrar u ocultar.

bShow
[in] Si es TRUE, la aplicación muestra la barra de control. De lo contrario, la aplicación oculta la barra de control.

bDelay
[in] Si es TRUE, retrase el ajuste del diseño de acoplamiento hasta que el marco llame a CFrameWndEx::AdjustDockingLayout. De lo contrario, vuelva a calcular el diseño de acoplamiento inmediatamente.

bActivate
[in] Si es TRUE, active la barra de control. De lo contrario, muestre la barra de control en un estado inactivo.

`CFrameWndEx::UpdateCaption`

Lo llama el marco para actualizar la barra de título de la ventana de marco.

void UpdateCaption();

Comentarios

`CFrameWndEx::WinHelp`

Invoca la aplicación WinHelp o la ayuda relacionada con el contexto.

virtual void WinHelp(
    DWORD dwData,
    UINT nCmd = HELP_CONTEXT);

Parámetros

dwData
Datos que dependen del parámetro nCmd. Para obtener una lista de valores posibles, consulte WinHelp.

nCmd
El comando de ayuda. Para obtener una lista de valores posibles, consulte WinHelp.

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CFrameWnd

Clase CFrameWndEx

Sintaxis

Miembros

Métodos públicos

Ejemplo

Jerarquía de herencia

Requisitos

CFrameWndEx::ActiveItemRecalcLayout

Comentarios

CFrameWndEx::AddPane

Parámetros

Valor devuelto

CFrameWndEx::AdjustDockingLayout

Parámetros

Comentarios

CFrameWndEx::DelayUpdateFrameMenu

Parámetros

Comentarios

CFrameWndEx::DockPane

Parámetros

Comentarios

CFrameWndEx::DockPaneLeftOf

Parámetros

Valor devuelto

Comentarios

CFrameWndEx::EnableAutoHidePanes

Parámetros

Valor devuelto

Comentarios

CFrameWndEx::EnableDocking

Parámetros

Valor devuelto

Comentarios

CFrameWndEx::EnableFullScreenMainMenu

Parámetros

CFrameWndEx::EnableFullScreenMode

Parámetros

Comentarios

CFrameWndEx::EnableLoadDockState

Parámetros

CFrameWndEx::EnablePaneMenu

Parámetros

CFrameWndEx::GetActivePopup

Valor devuelto

CFrameWndEx::GetDefaultResId

Valor devuelto

CFrameWndEx::GetDockingManager

Valor devuelto

Comentarios

CFrameWndEx::GetMenuBar

Valor devuelto

CFrameWndEx::GetPane

Parámetros

Valor devuelto

CFrameWndEx::GetRibbonBar

Valor devuelto

Comentarios

CFrameWndEx::GetTearOffBars

Valor devuelto

CFrameWndEx::GetToolbarButtonToolTipText

Parámetros

Valor devuelto

Comentarios

CFrameWndEx::InsertPane

Parámetros

Valor devuelto

Comentarios

CFrameWndEx::IsFullScreen

Valor devuelto

Comentarios

CFrameWndEx::IsMenuBarAvailable

Valor devuelto

CFrameWndEx::IsPointNearDockSite

Parámetros

Valor devuelto

Comentarios

CFrameWndEx::IsPrintPreview

Valor devuelto

Comentarios

CFrameWndEx::LoadFrame

Clase `CFrameWndEx`

`CFrameWndEx::ActiveItemRecalcLayout`

`CFrameWndEx::AddPane`

`CFrameWndEx::AdjustDockingLayout`

`CFrameWndEx::DelayUpdateFrameMenu`

`CFrameWndEx::DockPane`

`CFrameWndEx::DockPaneLeftOf`

`CFrameWndEx::EnableAutoHidePanes`

`CFrameWndEx::EnableDocking`

`CFrameWndEx::EnableFullScreenMainMenu`

`CFrameWndEx::EnableFullScreenMode`

`CFrameWndEx::EnableLoadDockState`

`CFrameWndEx::EnablePaneMenu`

`CFrameWndEx::GetActivePopup`

`CFrameWndEx::GetDefaultResId`

`CFrameWndEx::GetDockingManager`

`CFrameWndEx::GetMenuBar`

`CFrameWndEx::GetPane`

`CFrameWndEx::GetRibbonBar`

`CFrameWndEx::GetTearOffBars`

`CFrameWndEx::GetToolbarButtonToolTipText`

`CFrameWndEx::InsertPane`

`CFrameWndEx::IsFullScreen`

`CFrameWndEx::IsMenuBarAvailable`

`CFrameWndEx::IsPointNearDockSite`

`CFrameWndEx::IsPrintPreview`

`CFrameWndEx::LoadFrame`

`CFrameWndEx::NegotiateBorderSpace`

`CFrameWndEx::OnActivate`

`CFrameWndEx::OnActivateApp`

`CFrameWndEx::OnChangeVisualManager`

`CFrameWndEx::OnClose`

`CFrameWndEx::OnCloseDockingPane`

`CFrameWndEx::OnCloseMiniFrame`

`CFrameWndEx::OnClosePopupMenu`

`CFrameWndEx::OnCmdMsg`

`CFrameWndEx::OnContextHelp`

`CFrameWndEx::OnCreate`

`CFrameWndEx::OnDestroy`

`CFrameWndEx::OnDrawMenuImage`

`CFrameWndEx::OnDrawMenuLogo`

`CFrameWndEx::OnDWMCompositionChanged`

`CFrameWndEx::OnExitSizeMove`

`CFrameWndEx::OnGetMinMaxInfo`

`CFrameWndEx::OnIdleUpdateCmdUI`

`CFrameWndEx::OnLButtonDown`

`CFrameWndEx::OnLButtonUp`

`CFrameWndEx::OnMenuButtonToolHitTest`