IPointerInactive::OnInactiveMouseMove 메서드(ocidl.h)

개체가 마우스 이벤트를 발생시키는 데 사용할 수 있도록 마우스 포인터를 개체 위로 이동했음을 알 수 있습니다. 이 메서드는 비활성 개체가 마우스 포인터 아래에 있을 때 WM_MOUSEMOVE 메서드를 수신할 때 컨테이너에서 호출됩니다.

구문

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

매개 변수

[in] pRectBounds

포함된 창의 클라이언트 좌표에 있는 개체 경계 사각형입니다. 이 매개 변수는 WM_MOUSEMOVE 메시지가 수신되었을 때 개체에 화면의 정확한 위치와 크기를 알려줍니다. 이 값은 클라이언트의 좌표계 단위로 지정됩니다.

[in] x

클라이언트가 포함된 창의 단위로 된 마우스 위치의 가로 좌표입니다.

[in] y

클라이언트가 포함된 창의 단위로 된 마우스 위치의 세로 좌표입니다.

[in] grfKeyState

키보드의 키보드 한정자 키의 현재 상태입니다. 가능한 값은 MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON 및 MK_RBUTTON 값의 조합일 수 있습니다.

반환 값

메서드가 성공하면 반환 값이 S_OK. 그렇지 않으면 E_FAIL.

설명

컨테이너는 IPointerInactive::GetActivationPolicy 메서드를 호출하여 개체의 활성화 정책을 확인한 후 개체 위에 마우스 포인터가 있음을 개체에 알리기 위해 이 메서드를 호출합니다. 개체가 해당 호출을 통해 현재 위치에서 활성화하도록 요청하지 않은 경우 컨테이너는 마우스 포인터가 개체 위에 유지되는 한 OnInactiveMouseMove 를 호출하여 후속 WM_MOUSEMOVE 메시지를 비활성 개체로 디스패치합니다. 그런 다음 개체는 마우스 이동 이벤트를 실행할 수 있습니다.

반올림 오류를 방지하고 개체 구현자에서 작업을 더 쉽게 하기 위해 이 메서드는 포함된 클라이언트 창의 단위, 즉 일반적인 HIMETRIC 단위 대신 개체가 표시되는 창에서 창 좌표를 사용합니다. 따라서 개체가 활성 상태이고 비활성 상태일 때 동일한 좌표와 코드 경로를 사용할 수 있습니다. 창 좌표는 마우스 위치를 지정합니다. 경계 사각형도 동일한 좌표계에 지정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h

추가 정보

IPointerInactive