Compartilhar via


AfxGetMainWnd

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

CWnd* AFXAPI AfxGetMainWnd( );

Valor de retorno

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

Se não houver nenhum objeto que 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 seu objeto de aplicativo.

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

Comentários

Se seu aplicativo não for um servidor OLE, em seguida, chamar essa função é equivalente ao referir-se diretamente ao m_pMainWnd membro de seu objeto de 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

Conceitos

Macros do MFC e globais

Referência

CWinThread::m_pMainWnd