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 activo de la aplicación en lugar directamente de hacer referencia al miembro de m_pMainWnd del objeto application.

CWnd* AFXAPI AfxGetMainWnd( );

Valor devuelto

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

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

Si AfxGetMainWnd se realiza 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 de un subproceso secundario de la aplicación, la función devuelve la ventana principal asociado al subproceso que hace la llamada.

Comentarios

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

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

Header: afxwin.h

Vea también

Referencia

CWinThread::m_pMainWnd

Conceptos

Macros y funciones globales de MFC