CMDIChildWndEx (clase)
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
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)
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de