LBItemFromPt 함수(commctrl.h)

목록 상자에 지정된 지점에서 항목의 인덱스를 검색합니다.

구문

int LBItemFromPt(
  HWND  hLB,
  POINT pt,
  BOOL  bAutoScroll
);

매개 변수

hLB

형식: HWND

검사 목록 상자에 대한 핸들입니다.

pt

형식: POINT

검사 화면 좌표를 포함하는 POINT 구조체입니다.

bAutoScroll

형식: BOOL

스크롤 플래그입니다. 이 매개 변수가 TRUE 이고 점이 목록 상자 바로 위 또는 아래에 있는 경우 함수는 목록 상자를 한 줄씩 스크롤하고 -1을 반환합니다. 그렇지 않으면 함수가 목록 상자를 스크롤하지 않습니다.

반환 값

형식: int

점이 목록 항목 위에 있으면 항목 식별자를 반환하고, 그렇지 않으면 -1을 반환합니다.

설명

LBItemFromPt 함수는 마지막으로 수행한 이후 최소 시간이 경과한 경우에만 목록 상자를 스크롤합니다. 타이밍은 DL_DRAGGING 알림 코드 또는WM_MOUSEMOVE 메시지가 처리될 때와 같이 함수가 연속해서 반복적으로 호출되는 경우 목록 상자가 너무 빠르게 스크롤되지 않도록 방지합니다.

지정된 지점이 목록 상자의 클라이언트 영역 밖에 있고 bAutoScroll 이 TRUE이면 함수는 항목 식별자를 반환하는 대신 목록 상자를 스크롤합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	commctrl.h
라이브러리	Comctl32.lib
DLL	Comctl32.dll