CMDIChildWndEx (clase)

Artículo
06/16/2023

La clase CMDIChildWndEx proporciona la funcionalidad de una ventana secundaria de interfaz de múltiples documentos (MDI) de Windows. Amplía la funcionalidad de la clase CMDIChildWnd. El marco requiere esta clase cuando una aplicación MDI utiliza determinadas clases MFC.

Para obtener información más detallada, consulta el código fuente que se ubica en la carpeta VC\atlmfc\src\mfc de la instalación de Visual Studio.

Sintaxis

class CMDIChildWndEx : public CMDIChildWnd

Miembros

Métodos públicos

Nombre	Descripción
CMDIChildWndEx::ActivateTopLevelFrame	El marco llama a este método internamente para activar el marco de nivel superior cuando la aplicación debe activarse desde una pestaña de la barra de tareas.
`CMDIChildWndEx::AddDockSite`	Este método no se usa ni se implementa.
CMDIChildWndEx::AddPane	Agrega un panel.
CMDIChildWndEx::AddTabbedPane	Agrega un panel con pestañas.
CMDIChildWndEx::AdjustDockingLayout	Ajusta el diseño de acoplamiento.
CMDIChildWndEx::CanShowOnMDITabs
CMDIChildWndEx::CanShowOnTaskBarTabs	Indica al marco si este elemento secundario MDI se puede mostrar en las pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::CanShowOnWindowsList	Devuelve TRUE si el nombre de la ventana secundaria MDI se puede mostrar en el cuadro de diálogo de la clase CMFCWindowsManagerDialog. En caso contrario, devuelve FALSE.
`CMDIChildWndEx::CreateObject`	El marco usa este método para crear una instancia dinámica de este tipo de clase.
CMDIChildWndEx::DockPane	Acopla un panel.
CMDIChildWndEx::DockPaneLeftOf	Acopla un panel a la izquierda de otro panel.
CMDIChildWndEx::EnableAutoHidePanes	Habilita el modo de ocultación automática de los paneles cuando se acoplan en los lados especificados de la ventana.
CMDIChildWndEx::EnableDocking	Habilita el acoplamiento de la ventana secundaria al marco principal.
CMDIChildWndEx::EnableTaskbarThumbnailClipRect	Habilita o deshabilita la selección automática de una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.
CMDIChildWndEx::GetDockingManager
CMDIChildWndEx::GetDocumentName	Devuelve el nombre del documento que se muestra en la ventana secundaria MDI.
CMDIChildWndEx::GetFrameIcon	El marco llama a este método para recuperar el icono de la ventana secundaria MDI.
CMDIChildWndEx::GetFrameText	El marco llama a este método para recuperar el texto de la ventana secundaria MDI.
CMDIChildWndEx::GetPane	Busca un panel por el identificador de control especificado.
CMDIChildWndEx::GetRelatedTabGroup
CMDIChildWndEx::GetTabbedPane	Devuelve un puntero a un panel de acoplamiento insertado que se convirtió en un documento con pestañas.
CMDIChildWndEx::GetTabProxyWnd	Devuelve la ventana de representación de pestañas que hay registrada con las pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::GetTaskbarPreviewWnd	El marco llama a este método cuando necesita obtener una ventana secundaria (normalmente, una vista o una ventana divisora) que se abrirá en una miniatura de pestaña de la barra de tareas de Windows 7.
CMDIChildWndEx::GetTaskbarThumbnailClipRect	El marco llama a este método cuando necesita seleccionar una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.
`CMDIChildWndEx::GetThisClass`	El marco llama a este método para obtener un puntero al objeto CRuntimeClass asociado a este tipo de clase.
CMDIChildWndEx::GetToolbarButtonToolTipText	El marco llama a este método para recuperar una información sobre herramientas de un botón de la barra de herramientas.
CMDIChildWndEx::InsertPane	Registra el panel especificado con el administrador de acoplamiento.
CMDIChildWndEx::InvalidateIconicBitmaps	Invalida la representación de mapa de bits emblemática de la ventana secundaria MDI.
CMDIChildWndEx::IsPointNearDockSite	Determina si un punto especificado está cerca del sitio de acoplamiento.
CMDIChildWndEx::IsReadOnly	Devuelve TRUE si el documento que se muestra en la ventana secundaria es de solo lectura. En caso contrario, devuelve FALSE.
CMDIChildWndEx::IsRegisteredWithTaskbarTabs	Devuelve TRUE si la ventana secundaria MDI se registró correctamente con pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::IsTabbedPane	Devuelve TRUE si la ventana secundaria MDI contiene un panel de acoplamiento. En caso contrario, devuelve FALSE.
CMDIChildWndEx::IsTaskbarTabsSupportEnabled	Indica si la ventana secundaria MDI puede aparecer en pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled	Indica si se ha habilitado o deshabilitado la selección automática de una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.
CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags	Combinación de marcas, que el marco pasa al método SetTaskbarTabProperties, cuando una pestaña (ventana secundaria MDI) se está registrando con pestañas de la barra de tareas de Windows 7. La combinación predeterminada es `STPF_USEAPPTHUMBNAILWHENACTIVE \| STPF_USEAPPPEEKWHENACTIVE`.
CMDIChildWndEx::OnGetIconicLivePreviewBitmap	El marco llama a este método cuando necesita obtener un mapa de bits para acceder a una vista previa dinámica de la ventana secundaria MDI.
CMDIChildWndEx::OnGetIconicThumbnail	El marco llama a este método cuando necesita obtener un mapa de bits para acceder a la miniatura emblemática de la ventana secundaria MDI.
CMDIChildWndEx::OnMoveMiniFrame	El marco llama a este método para mover una ventana minimarco.
CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton	El marco llama a este método cuando el usuario presiona el botón de cierre en una miniatura de pestaña de la barra de tareas.
CMDIChildWndEx::OnSetPreviewMode	El marco llama a este método para entrar en el modo de vista previa de impresión o salir de él.
CMDIChildWndEx::OnTaskbarTabThumbnailActivate	El marco llama a este método cuando la miniatura de pestaña de la barra de tareas debe procesar un mensaje WM_ACTIVATE.
CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate	El marco llama a este método cuando la miniatura de pestaña de la barra de tareas debe procesar un mensaje WM_MOUSEACTIVATE.
CMDIChildWndEx::OnTaskbarTabThumbnailStretch	El marco llama a este método cuando necesita ajustar un mapa de bits de vista previa de miniatura de la pestaña de la barra de tareas de Windows 7 de la ventana secundaria MDI.
CMDIChildWndEx::OnUpdateFrameTitle	El marco llama a este método para actualizar el título del marco. (Invalida `CMDIChildWnd::OnUpdateFrameTitle`).
CMDIChildWndEx::PaneFromPoint	Devuelve el panel que contiene el punto especificado.
`CMDIChildWndEx::PreTranslateMessage`	La clase CWinApp lo usa para traducir los mensajes de ventana antes de que se envíen a las funciones de Windows TranslateMessage y DispatchMessage . (Invalida CWnd::PreTranslateMessage).
CMDIChildWndEx::RecalcLayout	Vuelve a calcular el diseño de la ventana.
CMDIChildWndEx::RegisterTaskbarTab	Registra la ventana secundaria MDI con pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::RemovePaneFromDockManager	Quita un panel del administrador de acoplamiento.
CMDIChildWndEx::SetRelatedTabGroup
CMDIChildWndEx::SetTaskbarTabActive	Activa la pestaña de barra de tareas de Windows 7 correspondiente.
CMDIChildWndEx::SetTaskbarTabOrder	Inserta la ventana secundaria MDI antes de la ventana especificada en pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::SetTaskbarTabProperties	Establece las propiedades de una pestaña de la barra de tareas de Windows 7.
CMDIChildWndEx::SetTaskbarThumbnailClipRect	El marco llama a este método internamente para establecer el rectángulo de recorte para seleccionar una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.
CMDIChildWndEx::ShowPane
CMDIChildWndEx::UnregisterTaskbarTab	Quita la ventana secundaria MDI de las pestañas de la barra de tareas de Windows 7.
CMDIChildWndEx::UpdateTaskbarTabIcon	Actualiza el icono de pestaña de la barra de tareas de Windows 7.

Comentarios

Para sacar partido de las características de acoplamiento extendidas en las aplicaciones MDI, derive la clase de ventana secundaria MDI de la aplicación de CMDIChildWndEx en lugar de CMDIChildWnd.

Ejemplo

En el siguiente ejemplo se deriva una clase de CMDIChildWndEx. Este fragmento de código procede de Ejemplo de VisualStudioDemo: aplicación de Visual Studio de MFC.

class CChildFrame : public CMDIChildWndEx
{
   DECLARE_DYNCREATE(CChildFrame)
public:
   CChildFrame();

   // Overrides
public:
   virtual BOOL PreCreateWindow(CREATESTRUCT &cs);
   virtual void ActivateFrame(int nCmdShow = -1);

   virtual BOOL IsReadOnly();
   virtual LPCTSTR GetDocumentName(CObject **pObj);

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

protected:
   afx_msg int OnCreate(LPCREATESTRUCT lpCreateStruct);

   DECLARE_MESSAGE_MAP()
};

Jerarquía de herencia

Requisitos

Encabezado: afxMDIChildWndEx.h

CMDIChildWndEx::AddPane

Agrega un panel.

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

Parámetros

pControlBar
[in] Puntero al panel.

bTail
[in] TRUE para agregar el panel al final de la lista de paneles para el administrador de acoplamiento; de lo contrario, FALSE.

Valor devuelto

TRUE si el panel se registró correctamente con el administrador de acoplamiento; de lo contrario, FALSE.

CMDIChildWndEx::AddTabbedPane

Agrega un panel con pestañas.

void AddTabbedPane(CDockablePane* pControlBar);

Parámetros

pControlBar
[in] Puntero al panel.

CMDIChildWndEx::AdjustDockingLayout

Ajusta el diseño de acoplamiento.

virtual void AdjustDockingLayout(HDWP hdwp = NULL);

Parámetros

hdwp
[in] Manipulador de una estructura de posición de ventana diferida.

CMDIChildWndEx::CanShowOnMDITabs

virtual BOOL CanShowOnMDITabs();

Valor devuelto

Comentarios

CMDIChildWndEx::CanShowOnWindowsList

Especifica si el nombre de la ventana secundaria MDI se puede mostrar en el cuadro de diálogo de la clase CMFCWindowsManagerDialog.

virtual BOOL CanShowOnWindowsList();

Valor devuelto

TRUE si la ventana se puede mostrar en el cuadro de diálogo Ventanas; de lo contrario, FALSE.

Comentarios

Invalide este método en una clase derivada y devuelva FALSE si la ventana no debe mostrarse en el cuadro de diálogo Ventanas. La llamada a esta función se realiza desde CMFCWindowsManagerDialog.

CMDIChildWndEx::DockPane

Acopla un panel.

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

Parámetros

pBar
[in] Puntero al panel.

nDockBarID
[in] Identificador del panel.

lpRect
[in] Puntero a un rectángulo.

Comentarios

El parámetro lpRect no se usa.

CMDIChildWndEx::DockPaneLeftOf

Acopla un panel a la izquierda de otro panel.

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

Parámetros

pBar
Puntero al panel que se va a acoplar.

pLeftOf
Puntero al panel que actúa como punto de referencia.

Valor devuelto

TRUE si la operación se realiza correctamente; si hay errores, devuelve FALSE.

Comentarios

Este método toma el panel especificado por pBar y lo acopla en el lado izquierdo del panel especificado por pLeftOf.

Llame a este método cuando quiera acoplar varios paneles en un orden predefinido.

CMDIChildWndEx::EnableAutoHidePanes

Habilita el modo de ocultación automática de los paneles cuando se acoplan en los lados especificados de la ventana.

BOOL EnableAutoHidePanes(DWORD dwDockStyle);

Parámetros

dwDockStyle
[in] Especifica los lados de la ventana de marco principal que se habilitan. Use una o varias de las marcas siguientes:

CBRS_ALIGN_LEFT
CBRS_ALIGN_RIGHT
CBRS_ALIGN_TOP
CBRS_ALIGN_BOTTOM

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

CMDIChildWndEx::EnableDocking

Habilita el acoplamiento de la ventana secundaria al marco principal.

BOOL EnableDocking(DWORD dwDockStyle);

Parámetros

dwDockStyle
[in] Especifica la alineación de acoplamiento que se va a habilitar.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

Comentarios

Llame a este método para habilitar la alineación de acoplamiento en el marco principal. Puede pasar una combinación de marcas CBRS_ALIGN_ (para más información, consulte CControlBar::EnableDocking).

CMDIChildWndEx::GetDockingManager

CDockingManager* GetDockingManager();

Valor devuelto

Comentarios

CMDIChildWndEx::GetDocumentName

Devuelve el nombre del documento que se muestra en la ventana secundaria MDI.

virtual LPCTSTR GetDocumentName(CObject** pObj);

Valor devuelto

Puntero a una cadena que contiene el nombre de un documento.

Comentarios

Un documento es lo que la ventana secundaria MDI muestra. Por lo general, la ventana muestra los datos cargados desde un archivo o guardados en él. Por lo tanto, el nombre del documento es el nombre del archivo. La implementación predeterminada de GetDocumentName devuelve una cadena obtenida de CDocument::GetPathName.

Si la ventana muestra un documento que no se carga desde un archivo, invalide este método en una clase derivada y devuelva un identificador de documento único.

El marco llama a GetDocumentName cuando guarda el estado de todos los documentos abiertos. La cadena devuelta se escribe en el Registro.

Cuando el marco restaura el estado más adelante, el nombre del documento se lee del Registro y se pasa a CMDIFrameWndEx::CreateDocumentWindow. Invalide este método en una clase derivada de CMDIFrameWndEx y cree o abra un documento que tenga este nombre y que lea en el archivo con este nombre. Si el documento no se basa en un archivo, cree el documento según el identificador de documento en sí. Realice estas acciones solo si tiene previsto guardar y restaurar documentos.

Ejemplo

En el siguiente ejemplo se muestra el uso del método GetDocumentName. Este fragmento de código procede de Ejemplo de VisualStudioDemo: aplicación de Visual Studio de MFC.

LPCTSTR CChildFrame::GetDocumentName(CObject **pObj)
{
   if (DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL)
   {
      return g_strStartViewName;
   }
   return CMDIChildWndEx::GetDocumentName(pObj);
}

CMDIChildWndEx::GetFrameIcon

El marco llama a este método para recuperar el icono de la ventana secundaria MDI.

virtual HICON GetFrameIcon() const;

Valor devuelto

Identificador de un icono de ventana.

Comentarios

El marco llama a este método para determinar qué icono se va a mostrar en la pestaña MDI que contiene la ventana de marco secundaria MDI.

De forma predeterminada, este método devuelve el icono de ventana. Invalide GetFrameIcon en una clase derivada de CMDIChildWndEx para personalizar este comportamiento.

CMDIChildWndEx::GetFrameText

El marco llama a este método para recuperar el texto de la ventana secundaria MDI.

virtual CString GetFrameText() const;

Valor devuelto

Cadena que contiene el texto de la ventana de marco.

Comentarios

El marco llama a este método para determinar qué texto se va a mostrar en la pestaña MDI que contiene la ventana de marco secundaria MDI.

De forma predeterminada, este método devuelve el texto de ventana. Invalide GetFrameText en una clase derivada de CMDIChildWndEx para personalizar este comportamiento.

CMDIChildWndEx::GetPane

Busca un panel por el identificador de control especificado.

CBasePane* GetPane(UINT nID);

Parámetros

Nid
[in] Identificador de control del panel que se va a buscar.

Valor devuelto

Puntero al panel, si se encontró; de lo contrario, es NULL.

CMDIChildWndEx::GetRelatedTabGroup

CMFCTabCtrl* GetRelatedTabGroup();

Valor devuelto

Comentarios

CMDIChildWndEx::GetTabbedPane

Devuelve un puntero a un panel de acoplamiento que forma parte de un grupo de documentos con pestañas MDI.

CDockablePane* GetTabbedPane() const;

Valor devuelto

Puntero a un panel de acoplamiento que forma parte de un grupo de documentos con pestañas MDI.

CMDIChildWndEx::GetToolbarButtonToolTipText

El marco llama a este método para recuperar una información sobre herramientas de un botón de la barra de herramientas.

virtual BOOL GetToolbarButtonToolTipText(
    CMFCToolBarButton*,
    CString&);

Valor devuelto

TRUE si se ha mostrado la información sobre herramientas. La implementación predeterminada devuelve FALSE.

Comentarios

Invalide este método si desea mostrar información sobre herramientas personalizada de los botones de la barra de herramientas.

CMDIChildWndEx::InsertPane

Registra el panel especificado con el administrador de acoplamiento.

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

Parámetros

pControlBar
[in] Puntero al panel que se va a insertar.

pTarget
[in] Puntero al panel adyacente.

bAfter
[in] Si es TRUE, pControlBar se inserta después de pTarget. Si es FALSE, pControlBar se inserta antes de pTarget.

Valor devuelto

TRUE si el método se realiza correctamente; de lo contrario, FALSE.

CMDIChildWndEx::IsPointNearDockSite

Determina si un punto especificado está cerca del sitio de acoplamiento.

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

Parámetros

point
[in] El punto especificado.

dwBarAlignment
[in] Especifica el borde que está cerca del punto. Los valores posibles son CBRS_ALIGN_LEFT, CBRS_ALIGN_RIGHT, CBRS_ALIGN_TOP y CBRS_ALIGN_BOTTOM

bOuterEdge
[in] TRUE si el punto está cerca del borde exterior del sitio de acoplamiento; de lo contrario, FALSE.

Valor devuelto

TRUE si el punto está cerca del sitio de acoplamiento; de lo contrario, FALSE.

Comentarios

El punto está cerca del sitio de acoplamiento cuando se encuentra dentro del conjunto de sensibilidad en el administrador de acoplamiento. La sensibilidad predeterminada es de 15 píxeles.

CMDIChildWndEx::IsReadOnly

Especifica si el documento que se muestra en la ventana secundaria es de solo lectura.

virtual BOOL IsReadOnly();

Valor devuelto

TRUE si el documento es de solo lectura; en caso contrario, FALSE.

Comentarios

Esta función se usa para impedir que se guarden documentos de solo lectura.

Ejemplo

En el siguiente ejemplo se muestra cómo invalidar el método IsReadOnly. Este fragmento de código procede de Ejemplo de VisualStudioDemo: aplicación de Visual Studio de MFC.

BOOL CChildFrame::IsReadOnly()
{
   return DYNAMIC_DOWNCAST(CStartView, GetActiveView()) != NULL;
}

CMDIChildWndEx::IsTabbedPane

Especifica si la ventana secundaria MDI contiene un panel de acoplamiento.

BOOL IsTabbedPane() const;

Valor devuelto

TRUE si la ventana secundaria MDI contiene un panel de acoplamiento que se convirtió en un documento con pestañas; en caso contrario, FALSE.

CMDIChildWndEx::OnMoveMiniFrame

El marco llama a este método para mover una ventana minimarco.

virtual BOOL OnMoveMiniFrame(CWnd* pFrame);

Parámetros

pFrame
[in] Puntero a una ventana minimarco.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

CMDIChildWndEx::OnSetPreviewMode

El marco llama a este método para entrar en el modo de vista previa de impresión o salir de él.

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

Parámetros

bPreview
[in] Si es TRUE, se entra en el modo de vista previa de impresión. Si es FALSE, se sale del modo de vista previa de impresión.

pState
[in] Puntero a la estructura de estado de vista previa de impresión.

CMDIChildWndEx::OnUpdateFrameTitle

El marco llama a este método para actualizar el título del marco.

virtual void OnUpdateFrameTitle(BOOL bAddToTitle);

Parámetros

bAddToTitle
[in] Si es TRUE, se agrega el nombre del documento al título.

CMDIChildWndEx::PaneFromPoint

Devuelve el panel que contiene 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] Especifica el punto, en coordenadas de pantalla, que se va a comprobar.

nSensitivity
[in] Aumente el área de búsqueda por esta cantidad. Un panel cumple con los criterios de búsqueda si el punto dado cae en el área aumentada.

bExactBar
[in] TRUE para omitir el parámetro nSensitivity; de lo contrario, FALSE.

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

dwAlignment
[in] Si se encuentra un panel en el punto especificado, este parámetro contiene el lado del panel más cercano al punto especificado. Para obtener más información, vea la sección Comentarios.

Valor devuelto

Puntero al objeto derivado de CBasePane que contiene el punto dado, o bien NULL si no se encontró ningún panel.

Comentarios

Llame a este método para determinar si un panel contiene el punto especificado según las condiciones especificadas, como la clase en tiempo de ejecución y la visibilidad.

Cuando se devuelve la función y se encuentra un panel, dwAlignment contiene la alineación del punto especificado. Por ejemplo, si el punto estaba más cercano a la parte superior del panel, dwAlignment se establece en CBRS_ALIGN_TOP.

CMDIChildWndEx::RecalcLayout

Vuelve a calcular el diseño de la ventana.

virtual void RecalcLayout(BOOL bNotify = TRUE);

Parámetros

bNotify
[in] Si es TRUE, el elemento activo en contexto de la ventana recibe la notificación del cambio de diseño.

CMDIChildWndEx::RemovePaneFromDockManager

Quita un panel del administrador de acoplamiento.

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

Parámetros

pControlBar
[in] Puntero al panel que se va a quitar.

bDestroy
[in] Si es TRUE, se destruye el panel quitado.

bAdjustLayout
[in] Si es TRUE, ajuste el diseño de acoplamiento de inmediato.

bAutoHide
[in] Si es TRUE, el diseño de acoplamiento está relacionado con la lista de barras de ocultación automática. Si es FALSE, el diseño de acoplamiento está relacionado con la lista de paneles normales.

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

CMDIChildWndEx::SetRelatedTabGroup

void SetRelatedTabGroup(CMFCTabCtrl* p);

Parámetros

[in] p

Comentarios

CMDIChildWndEx::ShowPane

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

Parámetros

[in] pBar

[in] bShow

[in] bDelay

[in] bActivate

Comentarios

CMDIChildWndEx::UpdateTaskbarTabIcon

Actualiza el icono de pestaña de la barra de tareas de Windows 7.

virtual void UpdateTaskbarTabIcon(HICON hIcon);

Parámetros

hIcon
Identificador de un icono que se va a mostrar en la pestaña de la barra de tareas de Windows 7.

Comentarios

CMDIChildWndEx::UnregisterTaskbarTab

Quita la ventana secundaria MDI de las pestañas de la barra de tareas de Windows 7.

void UnregisterTaskbarTab(BOOL bCheckRegisteredMDIChildCount = TRUE);

Parámetros

bCheckRegisteredMDIChildCount
Especifica si esta función necesita comprobar el número de ventanas secundarias MDI registradas con pestañas MDI. Si este número es 0, esta función quita el rectángulo de recorte de la miniatura de la barra de tareas de la aplicación.

Comentarios

CMDIChildWndEx::SetTaskbarThumbnailClipRect

El marco llama a este método para establecer el rectángulo de recorte para seleccionar una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.

virtual BOOL SetTaskbarThumbnailClipRect(CRect rect);

Parámetros

rect
Especifica el nuevo rectángulo de recorte. Si el rectángulo está vacío o es NULL, el recorte se quita.

Valor devuelto

TRUE si es correcto; en caso contrario, FALSE.

Comentarios

CMDIChildWndEx::SetTaskbarTabProperties

Establece las propiedades de una pestaña de la barra de tareas de Windows 7.

void SetTaskbarTabProperties(DWORD dwFlags);

Parámetros

dwFlags
Combinación de valores STPFLAG. Para obtener más información, vea ITaskbarList4::SetTabProperties.

Comentarios

CMDIChildWndEx::SetTaskbarTabOrder

Inserta la ventana secundaria MDI antes de la ventana especificada en pestañas de la barra de tareas de Windows 7.

void SetTaskbarTabOrder(CMDIChildWndEx* pWndBefore = NULL);

Parámetros

pWndBefore
Puntero a la ventana secundaria MDI cuya miniatura se inserta a la izquierda. Esta ventana ya debe estar registrada mediante RegisterTaskbarTab. Si este valor es NULL, la nueva miniatura se agrega al final de la lista.

Comentarios

CMDIChildWndEx::SetTaskbarTabActive

Activa la pestaña de barra de tareas de Windows 7 correspondiente.

void SetTaskbarTabActive();

Comentarios

CMDIChildWndEx::RegisterTaskbarTab

Registra la ventana secundaria MDI con pestañas de la barra de tareas de Windows 7.

virtual void RegisterTaskbarTab(CMDIChildWndEx* pWndBefore = NULL);

Parámetros

Comentarios

CMDIChildWndEx::OnTaskbarTabThumbnailStretch

El marco llama a este método cuando necesita ajustar un mapa de bits de vista previa de miniatura de una pestaña de la barra de tareas de Windows 7 de la ventana secundaria MDI.

virtual BOOL OnTaskbarTabThumbnailStretch(
    HBITMAP hBmpDst,
    const CRect& rectDst,
    HBITMAP hBmpSrc,
    const CRect& rectSrc);

Parámetros

hBmpDst
Identificador de un mapa de bits de destino.

rectDst
Especifica el rectángulo de destino.

hBmpSrc
Identificador de un mapa de bits de origen.

rectSrc
Especifica el rectángulo de origen.

Comentarios

Requisito: afxmdichildwndex.h

CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate

El marco llama a este método cuando la miniatura de pestaña de la barra de tareas debe procesar el mensaje WM_MOUSEACTIVATE.

virtual int OnTaskbarTabThumbnailMouseActivate(
    CWnd* pDesktopWnd,
    UINT nHitTest,
    UINT message);

Parámetros

pDesktopWnd
Especifica un puntero a la ventana primaria de nivel superior de la ventana que se está activando. El puntero puede ser temporal y no se debe almacenar.

nHitTest
Especifica el código del área de prueba de posicionamiento. Una prueba de posicionamiento es una prueba que determina la ubicación del cursor.

message
Especifica el número del mensaje del mouse.

Comentarios

La implementación predeterminada activa el marco secundario MDI relacionado.

CMDIChildWndEx::OnTaskbarTabThumbnailActivate

El marco llama a este método cuando la miniatura de pestaña de la barra de tareas debe procesar el mensaje WM_ACTIVATE.

virtual void OnTaskbarTabThumbnailActivate(
    UINT nState,
    CWnd* pWndOther,
    BOOL bMinimized);

Parámetros

nState
Especifica si CWnd se está activando o desactivando.

pWndOther
El puntero al CWnd que se está activando o desactivando. El puntero puede ser NULL y puede ser temporal.

bMinimized
Especifica el estado minimizado del CWnd que se está activando o desactivando. Un valor TRUE indica que la ventana está minimizada.

Comentarios

La implementación predeterminada activa el marco secundario MDI relacionado.

CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton

El marco llama a este método cuando el usuario presiona el botón de cierre en la miniatura de pestaña de la barra de tareas.

virtual void OnPressTaskbarThmbnailCloseButton();

Comentarios

CMDIChildWndEx::OnGetIconicThumbnail

El marco llama a este método cuando necesita obtener un mapa de bits para acceder a la miniatura emblemática de la ventana secundaria MDI.

virtual HBITMAP OnGetIconicThumbnail(
    int nWidth,
    int nHeight);

Parámetros

nWidth
Especifica el ancho del mapa de bits necesario.

nHeight
Especifica el alto del mapa de bits necesario.

Comentarios

CMDIChildWndEx::OnGetIconicLivePreviewBitmap

El marco llama a este método cuando necesita obtener un mapa de bits para acceder a una vista previa dinámica de la ventana secundaria MDI.

virtual HBITMAP OnGetIconicLivePreviewBitmap(
    BOOL bIsMDIChildActive,
    CPoint& ptLocation);

Parámetros

bIsMDIChildActive
Este parámetro es TRUE si se solicita el mapa de bits de la ventana secundaria MDI, que está activa actualmente, y la ventana principal no se minimiza. El procesamiento predeterminado en este caso crea una instantánea de la ventana principal.

ptLocation
Especifica la ubicación del mapa de bits en las coordenadas del cliente de la ventana principal (nivel superior). El destinatario de la llamada debe proporcionar este punto.

Valor devuelto

Si se procesa, devuelve un identificador a un mapa de bits válido de 32 BPP; en caso contrario, NULL.

Comentarios

Invalide este método en una clase derivada y devuelva un mapa de bits de 32 BPP válido de la vista previa dinámica de la ventana secundaria MDI. Se llama a este método solo cuando la ventana secundaria MDI se muestra en pestañas de la barra de tareas de Windows 7. Si se devuelve NULL, MFC llama a los identificadores predeterminados y obtiene los mapas de bits mediante PrintClient o PrintWindow.

CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags

Combinación de marcas, que el marco pasa al método SetTaskbarTabProperties, cuando una pestaña (ventana secundaria MDI) se está registrando con pestañas de la barra de tareas de Windows 7.

AFX_IMPORT_DATA static DWORD m_dwDefaultTaskbarTabPropertyFlags;

Comentarios

La combinación predeterminada es STPF_USEAPPTHUMBNAILWHENACTIVE | STPF_USEAPPPEEKWHENACTIVE.

CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled

Indica si se ha habilitado o deshabilitado la selección automática de una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.

BOOL IsTaskbarThumbnailClipRectEnabled() const;

Valor devuelto

Devuelve TRUE si la selección automática de una parte del área cliente de una ventana que se va a mostrar está habilitada; en caso contrario, FALSE.

Comentarios

CMDIChildWndEx::IsTaskbarTabsSupportEnabled

Indica si la ventana secundaria MDI puede aparecer en pestañas de la barra de tareas de Windows 7.

BOOL IsTaskbarTabsSupportEnabled();

Valor devuelto

TRUE si el elemento secundario MDI puede aparecer en las pestañas de la barra de tareas de Windows 7; FALSE si el elemento secundario MDI no puede aparecer en las pestañas de la barra de tareas de Windows 7.

Comentarios

CMDIChildWndEx::IsRegisteredWithTaskbarTabs

Devuelve TRUE si la ventana secundaria MDI se registró correctamente con pestañas de la barra de tareas de Windows 7.

BOOL IsRegisteredWithTaskbarTabs();

Valor devuelto

TRUE si la ventana secundaria MDI está registrada con pestañas de la barra de tareas de Windows 7; en caso contrario, FALSE.

Comentarios

CMDIChildWndEx::InvalidateIconicBitmaps

Invalida una representación de mapa de bits emblemática de la ventana secundaria MDI.

BOOL InvalidateIconicBitmaps();

Valor devuelto

Devuelve FALSE si la compatibilidad con la barra de tareas de Windows 7 está deshabilitada o si la ventana secundaria MDI no está registrada con pestañas de la barra de tareas de Windows 7; de lo contrario, devuelve TRUE.

Comentarios

Se debe llamar cuando el contenido activo o el tamaño de una ventana secundaria MDI ha cambiado.

CMDIChildWndEx::GetTaskbarThumbnailClipRect

El marco llama a este método cuando necesita seleccionar una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.

virtual CRect GetTaskbarThumbnailClipRect() const;

Valor devuelto

Rectángulo en coordenadas de ventanas. Este rectángulo se asigna al área cliente del marco de nivel superior. El rectángulo debe estar vacío para borrar el rectángulo de recorte.

Comentarios

CMDIChildWndEx::GetTaskbarPreviewWnd

El marco llama a este método cuando necesita obtener una ventana secundaria (normalmente, una vista o una ventana divisora) que se abrirá en una miniatura de pestaña de la barra de tareas de Windows 7.

virtual CWnd* GetTaskbarPreviewWnd();

Valor devuelto

Debe devolver un puntero válido a una ventana CWnd, cuya vista previa debe mostrarse en una pestaña de la barra de tareas de Windows 7 relacionada con esta ventana secundaria MDI. La implementación predeterminada devuelve una ventana secundaria de esta ventana secundaria MDI con el identificador de control AFX_IDW_PANE_FIRST (que suele ser una clase derivada de CView).

Comentarios

CMDIChildWndEx::GetTabProxyWnd

Devuelve la ventana de representación de pestañas que hay registrada con las pestañas de la barra de tareas de Windows 7.

CMDITabProxyWnd* GetTabProxyWnd();

Valor devuelto

Puntero a un objeto CMDITabProxyWnd que está registrado con pestañas de la barra de tareas de Windows 7.

Comentarios

CMDIChildWndEx::EnableTaskbarThumbnailClipRect

Habilita o deshabilita la selección automática de una parte del área cliente de una ventana para mostrarla como miniatura de esa ventana en la barra de tareas.

void EnableTaskbarThumbnailClipRect(BOOL bEnable = TRUE);

Parámetros

bEnable
Especifica si se va a habilitar (TRUE) o deshabilitar (FALSE) la selección automática de una parte del área cliente de una ventana que se va a mostrar.

Comentarios

CMDIChildWndEx::CanShowOnTaskBarTabs

Indica al marco si este elemento secundario MDI se puede mostrar en las pestañas de la barra de tareas de Windows 7.

virtual BOOL CanShowOnTaskBarTabs();

Valor devuelto

TRUE si el contenido de la ventana secundaria MDI se puede mostrar en miniaturas de la barra de tareas de Windows 7.

Comentarios

Invalide este método en una clase derivada y devuelva FALSE para deshabilitar la apariencia de esta ventana secundaria MDI en pestañas de la barra de tareas de Windows 7.

CMDIChildWndEx::ActivateTopLevelFrame

El marco llama a este método para activar el marco de nivel superior cuando la aplicación se activa desde una pestaña de la barra de tareas.

virtual void ActivateTopLevelFrame();

Comentarios

Consulte también

Gráfico de jerarquías
Clases
CMDIChildWnd (clase)
CMFCWindowsManagerDialog (clase)
CMDIFrameWndEx (clase)

Compartir a través de

CMDIChildWndEx (clase)

Sintaxis

Miembros

Métodos públicos

Comentarios

Ejemplo

Jerarquía de herencia

Requisitos

CMDIChildWndEx::AddPane

Parámetros

Valor devuelto

CMDIChildWndEx::AddTabbedPane

Parámetros

CMDIChildWndEx::AdjustDockingLayout

Parámetros

CMDIChildWndEx::CanShowOnMDITabs

Valor devuelto

Comentarios

CMDIChildWndEx::CanShowOnWindowsList

Valor devuelto

Comentarios

CMDIChildWndEx::DockPane

Parámetros

Comentarios

CMDIChildWndEx::DockPaneLeftOf

Parámetros

Valor devuelto

Comentarios

CMDIChildWndEx::EnableAutoHidePanes

Parámetros

Valor devuelto

CMDIChildWndEx::EnableDocking

Parámetros

Valor devuelto

Comentarios

CMDIChildWndEx::GetDockingManager

Valor devuelto

Comentarios

CMDIChildWndEx::GetDocumentName

Valor devuelto

Comentarios

Ejemplo

CMDIChildWndEx::GetFrameIcon

Valor devuelto

Comentarios

CMDIChildWndEx::GetFrameText

Valor devuelto

Comentarios

CMDIChildWndEx::GetPane

Parámetros

Valor devuelto

CMDIChildWndEx::GetRelatedTabGroup

Valor devuelto

Comentarios

CMDIChildWndEx::GetTabbedPane

Valor devuelto

CMDIChildWndEx::GetToolbarButtonToolTipText

Valor devuelto

Comentarios

CMDIChildWndEx::InsertPane

Parámetros

Valor devuelto

CMDIChildWndEx::IsPointNearDockSite

Parámetros

Valor devuelto

Comentarios

CMDIChildWndEx::IsReadOnly

Valor devuelto

Comentarios

Ejemplo

CMDIChildWndEx::IsTabbedPane

Valor devuelto

CMDIChildWndEx::OnMoveMiniFrame

Parámetros

Valor devuelto

CMDIChildWndEx::OnSetPreviewMode

Parámetros

CMDIChildWndEx::OnUpdateFrameTitle

Parámetros