TrackMouseEvent 함수(winuser.h)

아티클
08/28/2023

마우스 포인터가 창을 벗어나거나 지정된 시간 동안 창 위에 있을 때 메시지를 게시합니다.

참고_TrackMouseEvent 함수는 TrackMouseEvent가 있는 경우 TrackMouseEvent를 호출하고, 그렇지 않으면 TrackMouseEvent를 에뮬레이트하지 _TrackMouseEvent.

구문

BOOL TrackMouseEvent(
  [in, out] LPTRACKMOUSEEVENT lpEventTrack
);

매개 변수

[in, out] lpEventTrack

형식: LPTRACKMOUSEEVENT

추적 정보를 포함하는 TRACKMOUSEEVENT 구조체에 대한 포인터입니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값은 0이 아닌 입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

마우스 포인터는 지정된 기간 동안 지정된 사각형 내에 있을 때 마우스 포인터를 가리키고 있는 것으로 간주됩니다. SystemParametersInfo를 호출합니다. 및 는 SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT 및 SPI_GETMOUSEHOVERTIME 값을 사용하여 사각형의 크기와 시간을 검색합니다.

함수는 다음 메시지를 게시할 수 있습니다.

메시지	Description
WM_NCMOUSEHOVER	창의 비클라이언트 영역에 대한 것을 제외하고 WM_MOUSEHOVER 것과 동일한 의미입니다.
WM_NCMOUSELEAVE	창의 비클라이언트 영역에 대한 것을 제외하고 WM_MOUSELEAVE 것과 동일한 의미입니다.
WM_MOUSEHOVER	TrackMouseEvent에 대한 이전 호출에 지정된 기간 동안 창의 클라이언트 영역 위로 마우스를 가져간 경우 이 메시지가 생성되면 가리키기 추적이 중지됩니다. 마우스 가리키기 동작을 추가로 추적해야 하는 경우 애플리케이션은 TrackMouseEvent를 다시 호출해야 합니다.
WM_MOUSELEAVE	마우스는 TrackMouseEvent에 대한 이전 호출에 지정된 창의 클라이언트 영역을 떠났습니다. TrackMouseEvent에 의해 요청된 모든 추적은 이 메시지가 생성될 때 취소됩니다. 마우스 가리키기 동작을 추가로 추적해야 하는 경우 마우스가 창 안에 다시 들어갈 때 애플리케이션에서 TrackMouseEvent를 호출해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll
API 세트	ext-ms-win-ntuser-mouse-l1-1-0(Windows 8에서 도입)