Compartir vía

CMDIChildWndEx (clase)

  • Artículo

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

CObject

CCmdTarget

CWnd

CFrameWnd

CMDIChildWnd

CMDIChildWndEx

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

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