Compartilhar via


AfxGetMainWnd

Se seu aplicativo for um servidor OLE, chame essa função para recuperar um ponteiro para a janela principal ativa do aplicativo em vez de se referir diretamente para o m_pMainWnd membro do objeto application.

CWnd* AFXAPI AfxGetMainWnd( );

Valor de retorno

Se o servidor tiver um objeto que esteja no local ativo dentro de um recipiente e este contêiner estiver ativo, essa função retorna um ponteiro para o objeto de janela de quadro que contém o documento ativo no local.

Se não há nenhum objeto está ativo no local dentro de um contêiner ou seu aplicativo não é um servidor OLE, essa função simplesmente retorna o m_pMainWnd do objeto application.

Se AfxGetMainWnd é chamado do thread principal do aplicativo, ele retorna a janela principal do aplicativo de acordo com a regras acima.Se a função é chamada de um thread secundário no aplicativo, a função retornará a janela principal associada ao thread que fez a chamada.

Comentários

Se seu aplicativo não é um servidor OLE, em seguida, chamar essa função é equivalente a referência diretamente para o m_pMainWnd membro do objeto application.

Exemplo

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

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWinThread::m_pMainWnd

Conceitos

Globais e Macros do MFC