Поделиться через


AfxGetMainWnd

Если приложение OLE-сервер, то эта функция вызывается для получения указателя на активный главное окно приложения, а не напрямую обращаться к члену m_pMainWnd объекта приложения.

CWnd* AFXAPI AfxGetMainWnd( );

Возвращаемое значение

Если сервер имеет объект, активны на месте внутри контейнера и этот контейнер активен, то эта функция возвращает указатель на объект окна фрейма, который содержит активный документ на месте.

Если объект, который активно на месте внутри контейнера или приложение не OLE-сервер, то функция просто возвращает m_pMainWnd объекта приложения.

Если AfxGetMainWnd вызывается из потока основного приложения, он возвращает главное окно приложения в соответствии с правилами в предыдущем.Если функция вызывается из вторичного потока в приложении, функция возвращает главное окно, связанный с потоком, который вызвал.

Заметки

Если приложение не OLE-сервер, то вызовом этой функции равнозначен напрямую обращаться к члену m_pMainWnd объекта приложения.

Пример

//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);

Требования

Header: afxwin.h

См. также

Ссылки

CWinThread::m_pMainWnd

Основные понятия

Макросы и глобальные MFC