Condividi tramite


AfxGetMainWnd

Se l'applicazione è un'applicazione server OLE, chiamare la funzione per recuperare un puntatore alla finestra principale attiva dell'applicazione anziché direttamente il riferimento al membro di m_pMainWnd oggetto applicazione.

CWnd* AFXAPI AfxGetMainWnd( );

Valore restituito

Se il server è un oggetto che è attivo sul posto in un contenitore e questo contenitore è attivo, la funzione restituisce un puntatore alla finestra cornice contenente il documento attivo sul posto.

Se non c " è un oggetto che è attivo sul posto all'interno di un contenitore, o dell'applicazione non è un server OLE, questa funzione restituisce semplicemente m_pMainWnd dell'oggetto applicazione.

Se AfxGetMainWnd viene chiamato dal thread principale dell'applicazione, restituisce la finestra principale dell'applicazione in base alle regole di precedenza.Se la funzione viene chiamata da un thread secondario nell'applicazione, la funzione restituisce la finestra principale associata al thread che ha effettuato la chiamata.

Note

Se l'applicazione non è un server OLE, quindi chiamare questa funzione è equivalente diretto a fare riferimento al membro di m_pMainWnd dell'oggetto applicazione.

Esempio

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

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

CWinThread::m_pMainWnd

Concetti

Macro MFC e Globals