Partager via


AfxGetMainWnd

Si votre application est OLE serveur, appelez cette fonction pour récupérer un pointeur dans la fenêtre principale active de l'application au lieu de référencer directement au membre de m_pMainWnd de l'objet application.

CWnd* AFXAPI AfxGetMainWnd( );

Valeur de retour

Si le serveur a un objet qui est actif sur place à l'intérieur d'un conteneur, et ce conteneur est actif, des retours de cette fonction un pointeur vers l'objet fenêtre frame qui contient le document actif sur place.

S'il n'y a aucun objet qui est actif sur place dans un conteneur, ou votre application n'est pas OLE serveur, cette fonction retourne simplement m_pMainWnd de votre objet d'application.

Si AfxGetMainWnd est appelée à partir de le thread principal de l'application, il retourne la fenêtre principale de l'application selon les règles ci-dessus.Si la fonction est appelée à partir d'un thread secondaire dans l'application, la fonction retourne la fenêtre principale associée au thread qui a provoqué l'appel.

Notes

Si votre application n'est pas OLE serveur, l'appel à cette fonction est équivalent à faire référence directement au membre d' m_pMainWnd de votre objet d'application.

Exemple

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

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CWinThread::m_pMainWnd

Concepts

Macro MFC et Globals