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

Confira também

Ipointerinactive