LVM_SORTITEMSEX 메시지

애플리케이션 정의 비교 함수를 사용하여 목록 뷰 컨트롤의 항목을 정렬합니다. 각 항목의 인덱스는 새 시퀀스를 반영하도록 변경됩니다. 이 메시지를 명시적으로 보내거나 ListView_SortItemsEx 매크로를 사용하여 보낼 수 있습니다.

매개 변수

wParam

비교 함수에 전달되는 애플리케이션 정의 값입니다.

lParam

애플리케이션 정의 비교 함수에 대한 포인터입니다. 두 목록 항목의 상대적 순서를 비교해야 할 때마다 정렬 작업 중에 호출됩니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다.

설명

비교 함수의 형식은 다음과 같습니다.

int CALLBACK CompareFunc(LPARAM lParam1, LPARAM lParam2, LPARAM lParamSort);  

이 메시지는 비교 함수에 전달되는 정보 형식을 제외하면 LVM_SORTITEMS와 유사합니다. LVM_SORTITEMSEX에서 lParam1은 첫 번째 항목의 현재 인덱스이고 lParam2는 두 번째 항목의 현재 인덱스입니다. 필요한 경우 항목에 대한 추가 정보를 검색하기 위해 LVM_GETITEMTEXT 메시지를 보낼 수 있습니다.

비교 함수는 첫 번째 항목이 두 번째 항목보다 선행해야 하는 경우 음수 값을, 첫 번째 항목이 두 번째 항목 뒤에 오는 경우 양수 값을, 두 항목이 동등하면 0을 반환해야 합니다.

참고

정렬 과정에서 목록 뷰 콘텐츠가 불안정합니다. 콜백 함수가 LVM_GETITEM(ListView_GetItem) 외에 목록 뷰 컨트롤에 메시지를 보내는 경우 결과를 예측할 수 없습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Commctrl.h