Condividi tramite


AfxGetMainWnd

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

CWnd* AFXAPI AfxGetMainWnd( );

Valore restituito

Se il server dispone di un oggetto che è attivo sul posto all'interno di un contenitore, e tale contenitore è attivo, questa funzione restituisce un puntatore all'oggetto cornice della finestra contenente il documento attivo sul posto.

Se non esiste alcun oggetto che è attivo sul posto all'interno di un contenitore, o l'applicazione non è un server OLE, la funzione restituisce semplicemente il m_pMainWnd dell'applicazione.

Se AfxGetMainWnd viene chiamata dalla thread principale dell'applicazione, essa restituisce la finestra principale dell'applicazione sulla base delle regole sopra riportate. Se la funzione viene chiamata da una thread secondaria nell'applicazione, la funzione restituisce la finestra principale associata al thread che ha effettuato la chiamata.

Note

Se l'applicazione non è un server OLE, chiamare questa funzione equivale a fare riferimento direttamente al membro m_pMainWnd dell'oggetto dell'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

Intestazione: afxwin.h

Vedere anche

Riferimenti

CWinThread::m_pMainWnd

Concetti

Macro e funzioni globali MFC