Compartir a través de

Método IPointerInactive::OnInactiveMouseMove (ocidl.h)

  • Artículo

Notifica al objeto que el puntero del mouse se ha movido sobre él para que el objeto pueda desencadenar eventos del mouse. El contenedor llama a este método al recibir un método WM_MOUSEMOVE cuando un objeto inactivo está bajo el puntero del mouse.

Sintaxis

HRESULT OnInactiveMouseMove(
  [in] LPCRECT pRectBounds,
  [in] LONG    x,
  [in] LONG    y,
  [in] DWORD   grfKeyState
);

Parámetros

[in] pRectBounds

Rectángulo delimitador de objetos, en coordenadas de cliente de la ventana contenedora. Este parámetro indica al objeto su posición y tamaño exactos en la pantalla cuando se recibió el mensaje WM_MOUSEMOVE. Este valor se especifica en unidades del sistema de coordenadas del cliente.

[in] x

Coordenada horizontal de la ubicación del mouse en unidades de la ventana contenedora del cliente.

[in] y

Coordenada vertical de la ubicación del mouse en unidades de la ventana contenedora del cliente.

[in] grfKeyState

Estado actual de las teclas modificadoras del teclado en el teclado. Los valores posibles pueden ser una combinación de cualquiera de los valores MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON y MK_RBUTTON.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto es S_OK. De lo contrario, es E_FAIL.

Comentarios

El contenedor llama a este método para notificar al objeto que el puntero del mouse está sobre el objeto después de comprobar la directiva de activación del objeto llamando al método IPointerInactive::GetActivationPolicy . Si el objeto no ha solicitado activarse en contexto a través de esa llamada, el contenedor envía los mensajes posteriores WM_MOUSEMOVE al objeto inactivo llamando a OnInactiveMouseMove siempre que el puntero del mouse permanezca sobre el objeto. A continuación, el objeto puede desencadenar eventos de movimiento del mouse.

Para evitar errores de redondeo y facilitar el trabajo en el implementador de objetos, este método toma coordenadas de ventana en las unidades de su ventana cliente contenedora, es decir, la ventana en la que se muestra el objeto, en lugar de las unidades HIMETRIC habituales. Por lo tanto, se pueden usar las mismas coordenadas y ruta de acceso del código cuando el objeto está activo e inactivo. Las coordenadas de la ventana especifican la posición del mouse. El rectángulo delimitador también se especifica en el mismo sistema de coordenadas.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ocidl.h

Consulte también

IPointerInactive