Compartir vía

Clase CFrameWndEx

  • Artículo

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 Invoca la ayuda relacionada con la aplicación o el WinHelp contexto.

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

CObject

CCmdTarget

CWnd

CFrameWnd

CFrameWndEx

Requisitos

Encabezado: afxframewndex.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.

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);

Parámetros

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

lp
[in] Puntero a una barra de herramientas.

Valor devuelto

TRUE si se ha eliminado la barra de herramientas; de lo contrario, FALSE.

Comentarios

CFrameWndEx::OnUpdateFrameMenu

Llamado por el marco para establecer el menú de marco.

virtual void OnUpdateFrameMenu(HMENU hMenuAlt);

Parámetros

hMenuAlt
[in] Manipulador del menú alternativo.

Comentarios

CFrameWndEx::OnUpdateFrameTitle

El marco llama a este método para actualizar la barra de título de la ventana de marco.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parámetros

bAddToTitle
[in] TRUE para agregar el título del documento activo a la barra de título de la ventana de marco; de lo contrario, FALSE.

Comentarios

CFrameWndEx::OnUpdatePaneMenu

Llamado por el marco para actualizar el menú del panel.

afx_msg void OnUpdatePaneMenu(CCmdUI* pCmdUI);

Parámetros

pCmdUI
[in] Puntero al objeto de interfaz de usuario del panel.

Comentarios

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.

afx_msg void OnWindowPosChanged(WINDOWPOS FAR* lpwndpos);

Parámetros

lpwndpos
[in] Puntero a una estructura WINDOWPOS que contiene el nuevo tamaño y posición.

Comentarios

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