Compartilhar via


AfxGetMainWnd

Se seu aplicativo for um servidor OLE, chamar essa função para recuperar um ponteiro para a janela principal ativa do aplicativo em vez de fazer referência diretamente ao membro de m_pMainWnd do objeto do aplicativo.

CWnd* AFXAPI AfxGetMainWnd( );

Valor de retorno

Se o servidor tiver um objeto que está ativa no local dentro de um contêiner, e este contêiner estiver ativa, essa função retornará um ponteiro para o objeto da janela do tableau que contém o documento ativo no local.

Se não houver nenhum objeto que está ativa no local dentro de um contêiner, ou seu aplicativo não seja um servidor OLE, essa função retorna apenas m_pMainWnd do objeto do aplicativo.

Se AfxGetMainWnd é chamado de thread principal do aplicativo, retorna a janela principal do aplicativo de acordo com as 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, chame esta função é equivalente a fazer referência diretamente ao membro de m_pMainWnd do objeto do aplicativo.

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

Macros e globais MFC