Freigeben über


AfxGetMainWnd

Wenn die Anwendung ein OLE-Server ist, rufen Sie diese Funktion auf, um einen Zeiger auf den aktiven Hauptfenster der Anwendung abzurufen, statt den m_pMainWnd-Member des Anwendungsobjekts direkt zugreifen.

CWnd* AFXAPI AfxGetMainWnd( );

Rückgabewert

Wenn der Server ein Objekt, das sich innerhalb eines Containers direkt aktiviert ist und dieses Containers ist Aktiv aufweist, gibt diese Funktion einen Zeiger auf das Rahmenfenster Objekt zurück, das das direkt aktiviert Dokument enthält.

Wenn kein Objekt, das sich innerhalb eines Containers oder der Anwendung direkt aktiviert ist, ist kein OLE-Server vorhanden ist, gibt diese Funktion einfach m_pMainWnd des Anwendungsobjekts zurück.

Wenn AfxGetMainWnd vom primären Thread der Anwendung aufgerufen wird, gibt er das Hauptfenster der Anwendung entsprechend den oben genannten Regeln zurück.Wenn die Funktion aus einem sekundären Thread in der Anwendung aufgerufen wird, gibt die Funktion des Hauptfensters zurück, das dem Thread zugeordnet ist, der den Aufruf erfolgt sind.

Hinweise

Wenn die Anwendung keine OLE-Server ist, dann wird diese Funktion aufzurufen ist m_pMainWnd zu den Mitgliedern des Anwendungsobjekts direkt verweisen.

Beispiel

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

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWinThread::m_pMainWnd

Konzepte

MFC-Makros und -globale Werte