Compartilhar via


CWnd::OnMouseActivate

A estrutura chama essa função de membro quando o cursor está em uma janela e inativo 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 ativado. O ponteiro pode ser temporário e não deve ser armazenado.

  • nHitTest
    Especifica o código de área de em teste . Um teste de clique é um teste que determina o local do cursor.

  • message
    Especifica o número de mensagem do mouse.

Valor de retorno

Especifica se ativar CWnd e se descartar o evento do mouse. Deve ser um dos seguintes valores:

  • MA_ACTIVATE ativa o objeto de CWnd .

  • MA_NOACTIVATE não ativa o objeto de CWnd .

  • MA_ACTIVATEANDEAT ativa o objeto de CWnd e rejeita o evento do mouse.

  • MA_NOACTIVATEANDEAT não ativa o objeto de CWnd e não descarta o evento do mouse.

Comentários

A implementação padrão passa essa mensagem à janela pai antes que qualquer processamento ocorra. Se a janela pai retorna Verdadeiro, está processando paralisado.

Para obter uma descrição de código de área individuais hit-test, consulte a função de membro de OnNcHitTest

Dica

Essa função de membro é chamada pela estrutura para permitir que seu aplicativo manipule uma mensagem do windows.Parâmetros passados à sua função refletem os parâmetros recebidos pela estrutura quando a mensagem foi colocada.Se você chamar a implementação da classe base de essa função, essa implementação usará parâmetros passados originalmente com a mensagem e não os parâmetros que você fornece 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);
}

Requisitos

Cabeçalho: afxwin.h

Consulte também

Referência

CWnd Class

Gráfico da hierarquia

CWnd::OnNcHitTest

CWnd::OnMouseActivate