Sdílet prostřednictvím


AfxGetMainWnd

Pokud je aplikace OLE server, volání této funkce můžete načíst ukazatel na aktivní hlavní okno aplikace namísto přímo odkazující na m_pMainWnd člen objektu application.

CWnd* AFXAPI AfxGetMainWnd( );

Vrácená hodnota

Pokud má server objekt, který je v místě aktivní uvnitř kontejneru a tento kontejner je aktivní, tato funkce vrací ukazatel objektu rámeček okna obsahující v místě aktivního dokumentu.

Pokud neexistuje žádný objekt, který je aktivní v místě v rámci kontejneru nebo není aplikace OLE server, tato funkce jednoduše vrátí m_pMainWnd aplikačního objektu.

Pokud AfxGetMainWnd je volána z primární podprocesu aplikace, vrátí hlavní okno aplikace podle výše uvedených pravidel.Pokud tato funkce je volána z sekundární podprocesu aplikace, vrátí funkce hlavního okna přidružený k podprocesu, který volání uskutečnil.

Poznámky

Pokud není aplikace OLE server, je volání této funkce je ekvivalentní přímo se týkající m_pMainWnd člen aplikační objekt.

Příklad

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

Požadavky

Záhlaví: afxwin.h

Viz také

Referenční dokumentace

CWinThread::m_pMainWnd

Koncepty

MFC makra a Globals