CWnd::OnMouseActivate

Artigo
08/25/2010

A estrutura chama esta função de membro quando o cursor estiver em uma janela inativo e o usuário pressiona um botão do mouse.

afx_msg int OnMouseActivate(
   CWnd* pDesktopWnd,
   UINT nHitTest,
   UINT message 
);

Parâmetros

pDesktopWnd
Especifica um ponteiro para a janela pai de nível superior da janela que está sendo ativada.O ponteiro pode ser temporário e não deve ser armazenado.
nHitTest
Especifica o teste de hit código de área.Um teste de ocorrência é um teste que determina o local do cursor.
message
Especifica o número da mensagem do mouse.

Valor de retorno

Especifica se deve ser ativar o CWnd e se deseja descartar o evento de mouse. Ele deve ser um dos seguintes valores:

MA_ACTIVATE Ativar CWnd objeto.
MA_NO ativar Do not ativar CWnd objeto.
MA_ACTIVATEANDEAT Ativar CWnd objeto e descartar o evento de mouse.
MA_NOACTIVATEANDEAT Não ative CWnd objeto e descartar o evento de mouse.

Comentários

A implementação padrão passa essa mensagem para a janela pai antes que ocorra qualquer processamento.Se a janela pai retorna TRUE, processamento é interrompido.

Para obter uma descrição dos códigos de área de teste de hit individuais, consulte o OnNcHitTestfunção de membro

Observação:
Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipular uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi recebida.Se você chamar a implementação da classe de base dessa função, essa implementação usará os parâmetros passados originalmente com a mensagem e não os parâmetros que você fornecer para a função.

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipular uma mensagem do Windows.Os parâmetros passados para sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi recebida.Se você chamar a implementação da classe de base dessa função, essa implementação usará os parâmetros passados originalmente com a mensagem e não os parâmetros que você fornecer para a função.

Exemplo

// The code fragment below shows how to UI activate an ActiveX control.
// CMyAxCtrl is a COleControl-derived class.
int CMyAxCtrl::OnMouseActivate(CWnd* pDesktopWnd, UINT nHitTest, UINT message)
{
   OnActivateInPlace(TRUE, NULL);  // OnActivateInPlace() is an undocumented function
   return COleControl::OnMouseActivate(pDesktopWnd, nHitTest, message);
}