AfxGetMainWnd
Wenn es sich bei Ihrer Anwendung um einen OLE-Server handelt, rufen Sie diese Funktion auf, um einen Zeiger auf das aktiven Hauptfenster der Anwendung abzurufen, statt direkt auf den m_pMainWnd-Member des Anwendungsobjekts zu verweisen.
CWnd* AFXAPI AfxGetMainWnd( );
Rückgabewert
Wenn der Server über ein Objekt verfügt, das innerhalb eines Containers direkt aktiv ist, und dieser Container aktiv ist, gibt diese Funktion einen Zeiger auf das Rahmenfensterobjekt zurück, das das direkt aktive Dokument enthält.
Wenn es kein Objekt gibt, das innerhalb eines Containers direkt aktiv ist, oder es sich bei der Anwendung nicht um einen OLE-Server handelt, gibt diese Funktion lediglich den m_pMainWnd des Anwendungsobjekts zurück.
Wenn AfxGetMainWnd vom primären Thread der Anwendung aufgerufen wird, wird das Hauptfenster der Anwendung gemäß den oben genannten Regeln zurückgegeben. Wenn die Funktion von einem sekundären Thread in der Anwendung aufgerufen wird, gibt die Funktion das Hauptfenster zurück, das dem aufrufenden Thread zugeordnet ist.
Hinweise
Wenn es sich bei der Anwendung nicht um einen OLE-Server handelt, entspricht das Aufrufen dieser Funktion dem direkten Verweisen auf den m_pMainWnd-Member des Anwendungsobjekts.
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