Partager via


AfxGetMainWnd

Si votre application est serveur OLE, appelez cette fonction pour récupérer un pointeur vers la fenêtre principale active de l'application au lieu de faire référence directement au membre 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, cette fonction renvoie un pointeur vers l'objet fenêtre frame qui contient le document actif sur place.

S'il n'existe 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 application.

Si AfxGetMainWnd est appelé depuis le thread principal de l'application, il renvoie la fenêtre principale de l'application selon les règles ci-dessus. Si la fonction est appelée d'un thread secondaire dans l'application, la fonction renvoie la fenêtre principale associée au thread ayant fait l'appel.

Notes

Si votre application n'est pas serveur OLE, l'appel à cette fonction est équivalent à faire référence directement au membre de m_pMainWnd de votre objet 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

En-tête : afxwin.h

Voir aussi

Référence

CWinThread::m_pMainWnd

Concepts

macro MFC et Globals