Método IPointerInactive::OnInactiveMouseMove (ocidl.h)
Notifica o objeto de que o ponteiro do mouse se moveu sobre ele para que o objeto possa disparar eventos do mouse. Esse método é chamado pelo contêiner ao receber um método WM_MOUSEMOVE quando um objeto inativo está sob o ponteiro do mouse.
Sintaxe
HRESULT OnInactiveMouseMove(
[in] LPCRECT pRectBounds,
[in] LONG x,
[in] LONG y,
[in] DWORD grfKeyState
);
Parâmetros
[in] pRectBounds
O retângulo delimitador de objeto, nas coordenadas do cliente da janela que contém. Esse parâmetro informa ao objeto sua posição e tamanho exatos na tela quando a mensagem de WM_MOUSEMOVE foi recebida. Esse valor é especificado em unidades do sistema de coordenadas do cliente.
[in] x
A coordenada horizontal do local do mouse em unidades da janela que contém o cliente.
[in] y
A coordenada vertical da localização do mouse em unidades da janela que contém o cliente.
[in] grfKeyState
O estado atual das teclas modificadoras de teclado no teclado. Os valores possíveis podem ser uma combinação de qualquer um dos valores MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON e MK_RBUTTON.
Retornar valor
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, será E_FAIL.
Comentários
O contêiner chama esse método para notificar o objeto de que o ponteiro do mouse está sobre o objeto depois de verificar a política de ativação do objeto chamando o método IPointerInactive::GetActivationPolicy . Se o objeto não tiver solicitado a ativação in-loco por meio dessa chamada, o contêiner enviará mensagens WM_MOUSEMOVE subsequentes para o objeto inativo chamando OnInactiveMouseMove , desde que o ponteiro do mouse permaneça sobre o objeto. Em seguida, o objeto pode disparar eventos de movimentação do mouse.
Para evitar erros de arredondamento e facilitar o trabalho no implementador de objeto, esse método usa coordenadas de janela nas unidades de sua janela de cliente que contém, ou seja, a janela na qual o objeto é exibido, em vez das unidades HIMETRIC usuais. Portanto, as mesmas coordenadas e caminho de código podem ser usados quando o objeto está ativo e inativo. As coordenadas da janela especificam a posição do mouse. O retângulo delimitador também é especificado no mesmo sistema de coordenadas.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ocidl.h |