다음을 통해 공유


ListView_SetItemPosition 매크로(commctrl.h)

목록 보기 컨트롤(아이콘 또는 작은 아이콘 보기)에서 항목을 지정된 위치로 이동합니다. 이 매크로를 사용하거나 LVM_SETITEMPOSITION 메시지를 명시적으로 보낼 수 있습니다.

통사론

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

매개 변수

hwndLV

형식: HWND

목록 보기 컨트롤에 대한 핸들입니다.

i

형식: int

목록 보기 항목의 인덱스입니다.

x

형식: int

보기 좌표에서 항목의 왼쪽 위 모서리에 있는 새 x 위치입니다.

y

형식: int

보기 좌표에서 항목의 왼쪽 위 모서리에 있는 새 y 위치입니다.

반환 값

형식: BOOL

성공하면 TRUE 반환하거나, 그렇지 않으면 FALSE .

발언

목록 보기 컨트롤에 LVS_AUTOARRANGE 스타일이 있는 경우 목록 보기 컨트롤은 항목의 위치를 설정한 후에 정렬됩니다.

Windows Vista에서 LVS_AUTOARRANGE 스타일로 목록 보기 컨트롤에서 이 매크로를 호출하면 아무 작업도 수행되지 않으며 반환 값은 FALSE.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h