Compartir a través de


AfxGetMainWnd

Si la aplicación es un servidor OLE, llame a esta función para recuperar un puntero a la ventana principal activa de la aplicación en lugar de hacer referencia directamente al miembro m_pMainWnd del objeto de aplicación.

CWnd* AFXAPI AfxGetMainWnd( );

Valor devuelto

Si el servidor tiene un objeto que está activo en contexto dentro de un contenedor y ese contenedor está activo, la función devuelve un puntero al objeto de ventana marco que contiene el documento activo en contexto.

Si no hay ningún objeto activo en contexto dentro de un contenedor o la aplicación no es un servidor OLE, esta función devuelve simplemente el miembro m_pMainWnd del objeto de aplicación.

Si se llama a AfxGetMainWnd desde el subproceso principal de la aplicación, devuelve la ventana principal de la aplicación según las reglas anteriores. Si se llama a la función desde un subproceso secundario de la aplicación, la función devuelve la ventana principal asociada al subproceso que realizó la llamada.

Comentarios

Si la aplicación no es un servidor OLE, llamar a esta función equivale a hacer referencia directamente al miembro m_pMainWnd del objeto de aplicación.

Ejemplo

//The following line send a WM_CLOSE message  
//   to the Application's main window. This will cause the 
//   Application to exit.
AfxGetMainWnd()->PostMessage(WM_CLOSE, 0, 0);

Requisitos

Encabezado: afxwin.h

Vea también

Referencia

CWinThread::m_pMainWnd

Conceptos

Macros y variables globales de MFC